Customize your sign-in page

When users attempt to access to your applications, they're directed to an Okta-hosted sign-in page. Customize this page to provide a seamless user experience that fits your brand. You can apply your theme, modify the labels and URLs, and change the visibility settings.

Before you begin

  • You must be a super admin or an org admin, or have a role with customizations permissions.
  • Set a theme for your org.
  • Set your browser to at least 750 pixels in height to properly display the sign-in page.
  • If you plan to use the code editor, you need to first associate the brand with a custom domain. See Customize domain and email address.
  • If you used the code editors for the sign-in page but want to use custom branding instead, turn off the Code editor toggle. Customizations that you made with the code editors overwrite the branding for those pages.

Apply your theme

  1. In the Admin Console, go to CustomizationsBrands.
  2. Select a brand.
  3. Go to the Pages tab, and then click Edit or Configure for the Sign-in page.
  4. Optional for multibrand users. On the Page Design tab, choose a style from the Base style panel.
  5. Optional. If your org uses a custom sign-in page and you're familiar with HTML, you can make more advanced customizations with the code editor. See Style the sign-in page.
  6. Click Save and publish.

Change the labels and settings

  1. In the Admin Console, go to CustomizationsBrands.
  2. Select a brand.
  3. Go to the Pages tab. In the Sign-in page section, click Edit or Configure.
  4. On the Labels tab, click Edit for the type of label you want to edit.
  5. Enter new values for any of the headings, labels, and links that you want to customize. Leave the fields blank if you want to keep the default values.
  6. To add a custom link that appears on the authenticator page of the Sign-In Widget, enter values in the Custom link text and Custom link URL fields.
  7. To customize the link on the MFA Factor Verification page, enter new values in the Factor Page and Custom Link fields. Note: This is an Early Access feature.

  8. Click Save to draft. When a draft is saved but not yet published, yellow dots appear next to the tab label, top control buttons, and the section headings that contain changes.
  9. Click Publish.

Default links appear in the end users' display language or the browser language, but Okta doesn't localize custom links. If your custom link isn't in the end users' display or browser language, the sign-in page will have text in more than one language.

Related topics

Customize domain and email address

Style the Okta-hosted Sign-In Widget

Apply your theme to Okta email notifications

FAQ: How Blocking Third Party Cookies Can Potentially Impact Your Okta Environment