Introduction to Themes¶
Themes control the look and feel of the entire user interface, including images, logos, colors, fonts, sizing, and positioning. Themes can also be used to manage the login and interface header text, and the theme you choose can be applied to the Login page.
You can add any number of new themes, and edit existing themes. Themes are associated with user roles, and are typically associated with a specific customer (company).
The default theme for the Admin Portal ships with the system as can be used as the baseline template.
There are two ways to manage themes in the Admin Portal:
File-based themes (Less files)
If you’re using a file-based theme, this takes precedence. This is a CSS file that may be added, downloaded/exported, edited, and re-imported, to apply a theme.
See Less Files and Customizing Themes in the Advanced Configuration Guide
Custom branding options, configured directly within the GUI
Note
File-based themes are not used for the Business Admin Portal.
Theme Security¶
When importing a file-based theme to VOSS Automate at a particular hierarchy, you can choose to hide the theme from users at lower levels of the hierarchy via this setting on the Themes page: Hide from Lower Hierarchies.
In this case, the theme will not display in the list view for admins at lower levels of the hierarchy.
Themes and Interfaces¶
When importing or updating a file-based theme, you can choose the interface where the theme should apply, either the Administration portal (default), or to the Self-service interface. If no interface is specified, the default applies.
In the Themes settings (Use this Theme to style Login page), you can choose to apply a theme used for an interface, to also apply to the Login page across the system, for the selected interface.
Note
Currently, the system allows only a single theme to be applied to the Login page per interface. This means that a new or updated theme applied to a combination of interface and Login page for an existing theme overwrites the theme applied to the Login page style on the existing theme with the same interface setting.
The Login page theme can also be applied to the Login page when logging in. In this case, you add a suffix to the login request URL. See Customize Login Page Theme and Text in the Legacy Admin Portal. See Customize Login Page Theme and Text in the Legacy Admin Portal.
Manage Themes in the legacy Admin Portal¶
To manage themes in the legacy Admin Portal go to (default menu) Role Management > Themes.
Manage Themes in the Admin Portal¶
To manage themes in the Admin Portal (introduced at v21.2), go to (default menu) Role Management > Themes.
Manage Themes in the Business Admin Portal¶
To manage themes in the Business Admin Portal, go to (default menu) Tools > Themes).
