Introduction
The Theme tab in the Tenant Admin Portal lets admins customize the appearance and language settings of the DeviceLock app to match their organization’s branding.
Prerequisites
You must have admin access to the Tenant Admin Portal.
You must create DeviceLock Application. To create, refer How to create and configure Device Lock application.
Steps to Configure Theme Tab
Log in to the Tenant Admin Portal.
On the homepage, click the Device Lock Application to be configured.
The Device Lock Application details page is displayed.
Go to Theme tab and do the following:
Configure Theme Section
The Theme section allows you to customize the appearance of the application.
To configure the Theme section, do the following:
Click Theme section.
The Theme section is displayed.
Do the following:
Edit Customer logo.
Note: The maximum file dimensions for the logo are 264x72 px, with a maximum size of 1 MB in PNG format.
Foreground: Do one of the following:
Click or drag an image to the Foreground Image area to upload it.
Note: For best results, upload a portrait PNG image with a 1:2 ratio. The maximum file size is 2 MB, and the maximum resolution is 1080 x 2048 px.OR
Select the Solid Background checkbox and then enter the color code in the Foreground Color field.
Note: When the Solid Background checkbox is selected, the Foreground Image field changes to Foreground Color.
Primary Color/Button Default: Update the primary color code to define the primary button's default background and its hover-state text color.
Secondary Color/Hover State: Update the secondary color code to define the primary button's hover background and its default text color.
Customize Heading: Update the heading that appears at the top of the screen.
Heading Text Color: Update the text color code of the screen heading.
Widget Header/Footer Color: Update the background color for the Widget's header and footer.
Footer Text Color: Update the footer text color code in Login App.
Enable Help-text: Turn on Enable Help-text toggle and then enter the help text to display on the Identity Selection screen.
Note: The help text is displayed only on the Identity Selection screen and must not exceed 100 characters.
(Optional) In the Preview section, select one of the following tabs to preview the theme configuration:
Identity Selection: Preview the appearance of the identity selection screen displayed before user authentication.
Authentication: Preview the authentication screen displayed when users authenticate using their configured credentials.
Error: Preview how error messages and error screens are displayed to users during authentication failures.
Click Deploy Changes.
The Confirm Update pop-up box is displayed.
Click Update.
The DeviceLock theme Section is updated successfully.
Configure Language Support
The Language Support section lets you set the default language of the application and control how users can view or change it.
Note: Language Support translates all applicable screens automatically, including button labels. Custom label overrides are not supported, and dynamic messages received from the backend are not translated.
Click Language Support.
Select the Default App Language from dropdown.
Note:
This language is used for all users unless another language is selected.
Currently, six languages are supported: English, French, German, Spanish, and Portuguese.
(Optional) Select the Use device language as display language checkbox.
Note: If the device language is not supported, the application is displayed in the default language.
(Optional) Select the Show language selection dropdown checkbox to let users switch languages on the authenticate screen, wherever applicable. Then select the dropdown style:
Country flag, for example the US flag
Language code, for example EN
Click Deploy Changes.
The Confirm Update pop-up box is displayed.
Click Update.
The Theme tab is customized successfully.
Keywords
| DeviceLock Theme configuration | DeviceLock customization guide | Tenant Admin Portal theme settings












