Viewing Background Images on Default Mobile Brand Configurations in Okta
Last Updated:
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.
- Choose Customization, and then select Brands.
- Select the custom brand.
- Go to the Pages tab.
- Select Sign-In Page, and then select Configure.
- Select Code-editor.
- Enter the following CSS snippet:
@media only screen and (max-width: 600px){
#login-bg-image-id {
background-image: {{bgImageUrl}} !important
}
}
- Click Save and publish.
