Microsoft Entra External ID
Authentication

Customize Hosted Page Branding

In brief

The article now covers Microsoft-hosted page branding, prerequisites, Microsoft Graph management, and modern UX customization options. The modern Fluent, Basic and Advanced styling, and custom HTML capabilities are scheduled for preview on December 7, 2026, for enabled external tenants.

What Entra admins need to know

Admins can follow the updated default-branding instructions and review the preview customization options when available. No required action is stated.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Customize the neutralMicrosoft Entra External ID hosted page branding in your external tenant

[!INCLUDE applies-to-external-only]

After creating a newan external tenant, you can customize the end-user experience. Create a custom look and feel for users signing in to your apps by configuringconfigure Company branding settings for your tenant. With these settings, you can add your ownto customize its Microsoft-hosted authentication pages. Add background images, colors, company logos, and text to customize thecreate a consistent sign-in experiencesexperience across your apps.
You can also createmanage company branding programmatically with Microsoft Graph. Before you begin, ensure you have an external tenant, a registered application, and a user flows programmatically using the Company Branding Graph API.flow, as described in Prerequisites.

[!INCLUDE authentication-approaches]

Prerequisites

  • If you haven't already created your own Microsoft Entra external tenant, create one now.
  • Register an application.
  • Create a user flow.
  • Review the file size requirements for each image you want to add. You maymight need to use a photo editor to create the right-sizedresize images. The preferred image type for all imagesPNG is PNG,preferred, but JPG is accepted.

Review preview customization options

For guidance on the modern Fluent experience, Basic and Advanced styling, and custom HTML, see the modern UX and customization overview. Those preview capabilities use application branding themes, not the default-branding procedure below.

These capabilities are scheduled to become available in preview on December 7, 2026, for external tenants with the preview enabled. Continue using the default-branding instructions below to customize that experience.

Branding elements

By default, Microsoft offers aYour tenant starts with neutral branding for your tenant that can be personalizeddoesn't include preexisting Microsoft branding. Customize individual branding properties to suit your company's specific requirements. This default branding doesn't include any preexisting Microsoft branding.company. If the custom company branding fails to load, the sign-in page will automatically switch backreverts to this neutral branding. Additionally, each custom branding property can be manually added to the custom sign-in page.

You can customize this neutral branding with a custom background image or color, favicon, layout, header, and footer. You can also customize the sign-in form and add custom text to different instances or upload custom CSS. The following image displays the neutral default branding of the tenant. You can find the numbered branding elements and their corresponding descriptions after the image.

:::image type="content" source="media/how-to-customize-branding-customers/ciam-neutral-branding.png" alt-text="Screenshot of thea neutral branding.sign-in page with numbered branding elements." lightbox="media/how-to-customize-branding-customers/ciam-neutral-branding.png":::

  1. Neutral background.
  2. Favicon.
  3. Banner logo.
  4. Footer as a page layout element.
  5. Footer hyperlinks, such as Privacy & cookies, cookies and Terms of use.use.

How to customize the default sign-in experience

Before youTo customize any settings, the neutral default branding appears in your sign-in, sign-upup, and sign-out pages. You can customize this default experience with a custom background image or color, favicon, layout, header, and footer.pages, edit the company branding settings. You can also upload a custom CSS.

  1. Sign in to the Microsoft Entra admin center as at least aan Organizational Branding Administrator.
  2. If you have access to multiple tenants, use the Settings icon :::image type="icon" source="media/common/admin-center-settings-icon.png" border="false"::: in the top menu to switch to the external tenant you created earlier from the Directories + subscriptions menu.
  3. Browse to Company branding either by using the search bar or by navigating to Entra ID > Custom Branding.
  4. On the Default sign-in tab, select Edit.

To customize the sign-in page background and layout

Configure the background and layout to control how Microsoft-hosted pages display your branding:

  1. On the Basics tab, modify any of the background elements.

    • Favicon – The icon that displays in the web browser tab.

    • Background image – The large image that displays on the sign-in page. If you upload an image, it scales and cropcrops to fill the browser window.

    • Page background color – The color that replaces the background image whenever the image can’t be loaded, for example due to connection latency.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-basics-tab.png" alt-text="Screenshot of the company branding basics tab." lightbox="media/how-to-customize-branding-customers/company-branding-basics-tab.png":::

  2. Select Next: Layout if you would like to continue customizing or Review + save if you would like to save your changes.

  3. On the Layout tab, select the placement of web page elements on the sign-in page.

    • Template – Choose whether the background displays full-screen or partial-screen.

    • Header – Show or hide the header.

    • Footer – Show or hide the footer.

    • Custom CSS – Upload your owna CSS file to replace default Microsoft styling with your own styling for: color, font,customize colors, fonts, text size, position of elements,element positions, and displays for differentdisplay across devices and screen sizes.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-layout-tab.png" alt-text="Screenshot of the company branding layout tab." lightbox="media/how-to-customize-branding-customers/company-branding-layout-tab.png":::

  4. Select Next: Header if you would like to continue customizing or Review + save if you would like to save your changes.

To customize the logo, privacy link, and terms of use

Configure the header and footer to display your logo and policy links:

  1. On the Header tab, select the logo to display in the header of the sign-in page.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-header-tab.png" alt-text="Screenshot of the company branding header tab.":::

  2. Select Next: Footer if you would like to continue customizing or Review + save if you would like to save your changes.

  3. On the Footer tab, you can customize the URLs and link text for the privacy and terms of use hyperlinks that appear in the footer of the sign-in page.

    • Privacy & Cookies – Select the checkbox next to Privacy & Cookies to display this hyperlink in the footer. The Microsoft default privacy link displays unless you enter your own hyperlink Display text and URL.

    • Terms of Use – Select the checkbox next to Terms of Use to display this hyperlink in the footer. The Microsoft terms of use link displaydisplays unless you enter your own hyperlink Display text and URL.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-footer-tab.png" alt-text="Screenshot of the company branding footer tab." lightbox="media/how-to-customize-branding-customers/company-branding-footer-tab.png":::

  4. Select Next: Sign-in form if you would like to continue customizing or Review + save if you would like to save your changes.

To customize the sign-in form

Configure logos, hint text, and page text for the sign-in form:

  1. On the Sign-in form tab, configure elements of the sign-in form:

    • Banner logo – Displays on the sign-in page and in the user’s access panel.

    • Square logo (light theme) – Represents user accounts in your organization.

    • Square logo (dark theme) – IfUpload an alternative to the light theme square logo displays poorlyfor use on dark backgrounds, you can upload a logo to be used in its place when dark backgrounds are used.backgrounds.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-sign-in-form-tab.png" alt-text="Screenshot of the company branding sign-in form tab." lightbox="media/how-to-customize-branding-customers/company-branding-sign-in-form-tab.png":::

  2. Scroll to the lower half of the page and configure more elements of the sign-in form:

    • Username hint text – The hint text that displays in the username input field on the sign-in page (not recommended if guest users sign in to your app).

    • Sign-in page text – Appears at the bottom of the sign-in and sign-up pages. Guidelines:

      • Use a maximum of 1,024 characters maximumcharacters.
      • Don't include sensitive informationinformation.
      • Use this syntax to format text:
        • Hyperlink: [text](link)
        • Bold: **text** or __text__
        • Italics: *text* or _text_
        • Underline: ++text++

To customize self-service password reset

Configure the password reset link on Microsoft-hosted sign-in pages:

  1. Scroll to the Self-service password reset section to configure options for showing, hiding, or customizing the self-service password reset link on the sign-in page.

    • Show self-service password reset – Select this checkbox to display the self-service password link.

    • Common URL – Enter a password reset URL to use in place of the default Microsoft link.

    • Account collection display text – Enter link text to display in place ofreplace the Microsoft default text "Can’t access your account" text.

    • Password collection display text – Enter link text to display in place ofreplace the Microsoft default "Forgot password" text.

    :::image type="content" source="media/how-to-customize-branding-customers/company-branding-self-service-password-reset.png" alt-text="Screenshot of the company branding Self-service password reset. " lightbox="media/how-to-customize-branding-customers/company-branding-self-service-password-reset.png":::

  2. Select Next: Text if you would like to continue customizing or Review + save if you would like to save your changes.

To customize user attributes

For your tenant, you might have different requirementsCustomize labels for the information you want to collect during sign-up and sign-in. The tenant comes with a built-in set of information stored in attributes,attributes such as Given Name, Surname, City, and Postal Code. You can create custom attributes Code, and other sign-up and sign-in your tenant using thetext. Use Microsoft Graph API or in the portal under the Text tab in Company Branding. to customize this text:

  1. On the Text tab, select Add Custom Text.

  2. Select any of the options:

    • Select Attributes to override the default values.

    • Select Attribute collection to add a new attribute option that you would like to collect during the sign-up process.up.

    • Select Sign in to add custom text for the sign-in page.

    • Select Sign up to add custom text for the sign-inup page.

    • Select Sign-in/up one time code (SISU OTC) to add a custom title.

    :::::image type="content" source="media/how-to-customize-branding-customers/custom-text.png" alt-text="Screenshot of the company branding text tab." lightbox="media/how-to-customize-branding-customers/custom-text.png":::

  3. Select Next: Review to review all your modifications. Then select Save if you'd like to save your changes or Previous if you want to continue customizing.

Customize the sign-out experience

The sign-out experience automatically matches your sign-in branding. If you haven't customized sign-in branding, sign-out pages use the tenant's default neutral branding.

How to customize the tenant name

:::image type="content" source="media/how-to-customize-branding-customers/tenant-name.png" alt-text="Screenshot of the tenant name." lightbox="media/how-to-customize-branding-customers/tenant-name.png":::

To change the tenant name, follow these steps:

  1. Sign in to the Microsoft Entra admin center as at least aan Organizational Branding Administrator.

  2. If you have access to multiple tenants, use the Settings icon :::image type="icon" source="media/common/admin-center-settings-icon.png" border="false"::: in the top menu to switch to the external tenant you created earlier from the Directories + subscriptions menu.

  3. In the search bar, type and select Tenant properties.

  4. Edit the Name field.

    :::image type="content" source="media/how-to-customize-branding-customers/tenant-name-edit.png" alt-text="Screenshot of editing the tenant name.":::

  5. Select Save.

Customize your branding with the Microsoft Graph API

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…