<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-M74D8PB" height="0" width="0" style="display:none;visibility:hidden">
Loading
Skip to NavigationSkip to Main Content

Viewing Background Images on Default Mobile Brand Configurations in Okta

Administration
Okta Classic Engine
Okta Identity Engine

Overview

By default, the Okta Dashboard does not display a background image for mobile device browsers. This is the expected behavior for default brands. Enable the background image on mobile devices by using a custom brand and implementing a Cascading Style Sheets (CSS) snippet.

Applies To

  • Okta Identity Engine (OIE)
  • Okta Classic Engine
  • Okta Sign-in Widget
  • Default Brand
  • Custom Brand

Cause

The Okta Dashboard does not display a background image for mobile device browsers because this is the expected behavior for default brands.

Solution

What steps enable a background image for mobile devices?

Enable the background image on mobile devices by configuring a custom brand and adding a Cascading Style Sheets (CSS) snippet in the code editor.

  1. Choose Customization, and then select Brands.
  2. Select the custom brand.
  3. Go to the Pages tab.
  4. Select Sign-In Page, and then select Configure.
  5. Select Code-editor.
  6. Enter the following CSS snippet:
@media only screen and (max-width: 600px){
            #login-bg-image-id {
                background-image: {{bgImageUrl}} !important
            }
        }
  1. Click Save and publish.

Related References

Loading
Okta Support - Viewing Background Images on Default Mobile Brand Configurations in Okta