> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# Brand your login pages

Use custom branding on login pages to match your organization's standards. This is required for white-label deployments where Entrust Identity as a Service branding cannot be shown.

IDaaS lets you replace the default logo, favicon, colors, font, and browser tab title. These changes apply to all entry pages, including login, password reset, registration, and logout.

## Before you begin

Before you begin the customizations, you need the following:

- A **Site Administrator** role with permission to modify customization settings.
- A logo file ready (PNG or JPG format, up to 900 × 300 pixels).
- A favicon file ready (PNG or ICO format, 32 × 32 or 64 × 64 pixels recommended, 32 KB maximum).
- Your brand color hex values (primary, accent, and link colors).

## Upload your logo and favicon

Upload your organization's logo to replace the default Entrust logo on login pages.

1. Click Menu icon **> Customization > Theme**. The **Theme** page appears.
2. Select the **Custom Theme** tab.
3. Expand the **Brand and Logo** section.
4. Under **Company Logo**, click **Upload** and select your logo file.
5. Configure logo placement:
   - Set **Logo in Login Card** to **Show** to display the logo inside the login card, or **Hide** to remove it from the card.
   - Set **Logo Card Layout** to **Top** or **Left** to control where the logo appears relative to the login form.
   - Set **Logo Alignment** to **Center** or **Left**.
6. Optional: To display the logo in the page header, set **Logo in Header** to **Show** and choose the **Header Logo Scope** (**All Pages** or **Entry Pages Only**).
7. Under **Favicon**, click **Upload** and select your favicon file.

note

Logo files must be in PNG or JPG format up to 900 × 300 pixels. Favicons must be in PNG or ICO format, 32 × 32 or 64 × 64 pixels, and no larger than 32 KB.

## Set your brand colors

Define the colors that appear on login and authentication pages to match your corporate brand guidelines.

1. In the **Custom Theme** tab, expand the **Colors and Surfaces** section.
2. Set the **Primary Color** by clicking the color picker or entering a hex value. This color appears on primary buttons and key UI elements.
3. Set the **Accent Color** for secondary interactive elements.
4. Set the **Link Color** for hyperlinks on entry pages.
5. Choose a **Background Style**:
   - **Solid Color**: Select a single background color.
   - **Gradient**: Set a **Start Color**, **End Color**, and **Gradient Angle** (0°, 45°, 90°, or 135°).

## Choose a font family

Select a font that matches your organization's web presence.

1. In the **Custom Theme** tab, expand the **Typography** section.
2. Select a **Font Family** from the available options: Roboto, Arial, Helvetica Neue, Georgia, Verdana, or System UI.

info

The selected font applies to entry pages only (login, password reset, registration, and logout). It does not change the font in the administration portal.

## Set the browser tab title

Replace the default browser tab title with your organization's name or brand. The browser tab title is one of the customizable strings managed on the **Custom Messages** tab.

1. Go to the **Custom Messages** tab.
2. Select the target language from the locale drop-down.
3. Find the **Browser Tab Title** string (under the "Welcome / Branding" category, key `common.browserTitle`).
4. Enter your custom title in the **Custom Override** column.
5. Click **Save**.

You can use the `{}` placeholder to dynamically insert the company name.

For more details on working with custom messages, see [Customize login page text and messages](/docs/customization/customize-login-messages.md).

## Preview and save

The **Custom Theme** tab includes a live preview panel that shows how your changes render on login screens before you save them.

1. Review the preview panel on the right side of the page. It displays the login page, challenge page, password reset page, and user password page with your current settings applied.
2. When you are satisfied with the preview, click **Save**.

## Reset to defaults

If you need to revert your branding changes, you can reset the theme to Entrust defaults.

1. In the **Custom Theme** tab, click **Reset Theme**.
2. Confirm the reset.

This clears your custom colors and logo and reverts all brand settings to their defaults.

## Next steps

- [Customize the login page layout](/docs/customization/customize-login-layout-and-flow.md) to control card style, message placement, and login flow order.
- [Customize footer and legal notices](/docs/customization/customize-footer-and-legal-notices.md) to display your organization's legal terms.