---
title: Custom Branding
description: Use your own logo and colors in the Admin Portal.
originalPath: .tmp-workos-clone/packages/docs/content/admin-portal/custom-branding.mdx
---

## Introduction

You can customize the look and feel of the Admin Portal from the WorkOS Dashboard. Go to [Branding settings](https://dashboard.workos.com/branding) where you can:

- Upload your logos
- Set your brand color
- View your custom domains

![A screenshot showing the WorkOS Dashboard branding settings page.](https://images.workoscdn.com/images/fc67ec10-44e1-467c-a094-32ed3ff5bd92.png?auto=format&fit=clip&q=80)

## Logos and icons

You can upload custom branding assets which will be used in the Admin Portal as well as emails.

### Logo

Image with your company's logo and wordmark.

- **Usage:** Shown in the top left corner of the Admin Portal.
- **Requirements:** At least 160x160 px (JPG, PNG, or SVG. 100 KB max size)

![A screenshot showing the WorkOS Admin Portal and highlighting the custom logo.](https://images.workoscdn.com/images/ca579b3c-6a50-41aa-ad3e-62b32740b6c8.png?auto=format&fit=clip&q=50)

### Logo icon

A smaller, square version of the logo. This is often simply the logomark.

<style>{`
 .tight-bullets p {
    margin-bottom: var(--space-2);
  }
  .tight-bullets .rt-Box:has(.rt-Box) {
    margin-bottom: var(--space-2);
  }
`}</style>

<div class="tight-bullets">

- **Usage:**

  - Displayed in Admin Portal emails
  - Available for IT admins to
    download from the Admin Portal for configuring IdP-initiated SSO in Okta,
    Entra ID and Google Workspace.

- **Requirements:** At least 160x160 px with a
  1:1 aspect ratio (JPG, PNG, or SVG. 100 KB max size)

</div>

![A screenshot showing an email from WorkOS and highlighting the custom logo icon.](https://images.workoscdn.com/images/df8b54e6-a3fc-431b-8086-a01fb03388c7.png?auto=format&fit=clip&q=50)
![A screenshot showing the WorkOS Admin Portal and highlighting the custom logo icon download.](https://images.workoscdn.com/images/d07c701e-a051-4444-ae66-fc35eecb6791.png?auto=format&fit=clip&q=50)

### Favicon

A small icon that serves as branding for your website.

- **Usage:** Displayed in the address bar of the Admin Portal website.
- **Requirements:** At least 32x32 px with a 1:1 aspect ratio (JPG, PNG, GIF, SVG, WebP, AVIF, or ICO. 100 KB max size)

![A screenshot showing the WorkOS Admin Portal and highlighting the custom favicon.](https://images.workoscdn.com/images/15dd6370-961d-4d8b-97b1-6bfc3ef80143.png?auto=format&fit=clip&q=50)

### Brand color

Hex value used as the background color for buttons in the Admin Portal and emails.

![A screenshot showing the WorkOS Admin Portal and highlighting the custom button color.](https://images.workoscdn.com/images/080c0c45-08ee-44c4-b153-7b419174fc5e.png?auto=format&fit=clip&q=50)

![A screenshot showing an email from WorkOS and highlighting the custom button color.](https://images.workoscdn.com/images/6da61ac8-82f1-44e6-ab55-33d699841739.png?auto=format&fit=clip&q=50)

## Custom domains

WorkOS allows you to customize the domain you send API calls to, the domain used by the Admin Portal, and the from address used in emails sent to your customer's IT admin.

![A screenshot showing the WorkOS Dashboard branding settings page highlighting the custom domains section](https://images.workoscdn.com/images/b6afe130-219c-4e0e-8209-49b1a0fb6098.png?auto=format&fit=clip&q=80)

### Auth link domain

Controls the domain you send API calls to and the domain used in URL’s that face your customer’s IT admin such as ACS URL and SP Entity ID.

### Admin Portal domain

Controls the domain of Admin Portal setup links and Admin Portal sessions opened by your customer’s IT admin.

### Email domain

Controls the from address for emails sent to your customer's IT admin.

To configure custom domains, please reach out to [customer support](mailto:support@workos.com) for assistance.

## Team name

Your team name is visible in the Admin Portal and in the emails received by your customers’ organization admins.

![A screenshot showing the WorkOS Admin Portal and highlighting the page title.](https://images.workoscdn.com/images/0fd29434-3a5a-43ed-a446-45aec90f75da.png?auto=format&fit=clip&q=50)

![A screenshot showing an email by WorkOS and highlighting the sender name.](https://images.workoscdn.com/images/8d679e97-ceaa-4b94-bb75-290619c94085.png?auto=format&fit=clip&q=50)

## Support email address

Add a support email in the Dashboard to streamline communication with your customers’ organization admins. This email will be included in the footer of messages sent to them and set as the reply-to address, making it easy for admins to reach out with any questions.

![A screenshot showing an email with a custom support email address](https://images.workoscdn.com/images/8eb036ab-5fd0-44fe-81f3-6a69a8c38530.png?auto=format&fit=clip&q=50)