<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 Configuration
Administration
Okta Classic Engine
Okta Identity Engine
Overview

This article clarifies whether it is possible to set a background image specifically for mobile devices across various browsers, as opposed to desktop devices.

Applies To
  • Okta Sign-in Widget
  • Default Brand
  • Custom Brand
Cause

This is the expected behavior for default brands. The Okta Dashboard does not display a background image when accessed through a browser on a mobile device.

Solution

To enable the background image on mobile devices, use a Custom Brand and ensure the following Cascading Style Sheets (CSS) snippet is implemented:

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

Related References

Loading
Viewing Background Images on Default Mobile Brand Configuration