Setting the Default Theme#
VOSS Automate provides a number of options to set the default theme upon login.
The list below indicates the priority order in which a theme will be applied:
URL Parameter
The Login page theme can also be applied to the login page during the log in process. To to this, add URL parameter
theme=<theme-name>
to the login request URL. This applies and overrides any theme that is set as the Login theme.Note
For Self-service, if the theme value is set as
login?theme=cisco_selfservice
, the theme reverts to the Self-service theme set as the default.For example, when two themes are available in the system, XYZ and ABC, and XYZ login page is set as default:
Admin Portal (legacy):
https://instance/login/
- Login page will show use XYZ themehttps://instance/login/?theme=ABC
- Login page will show use ABC themeAdmin Portal (introduced at v21.2):
https://instance/portal/#/admin
- Login page will show use XYZ themehttps://instance/portal/#/login?targetAppMode=admin&theme=ABC
- Login page will show use ABC theme
Subdomain of hostname
If not 1. above:
If the login URL is not an IP address, but a hostname, then if the subdomain of the hostname matches a theme name, this theme will apply.
For example, if the hostname is
customer1.mydomain.com
, and a theme with the namecustomer1
exists, then this theme will be applied.Hostname matching is case-insensitive. Note that if multiple themes are for example available that match case-insensitively, no match will be made and the default theme will be applied.
Default login theme for the interface
If not 1 and 2 above:
If a theme has been created for the interface and Use this Theme to style Login page has been enabled, then this theme will be applied to the interface.
Pre-defined defaults
If not 1, 2, 3 above:
For the Self-service interface, the theme
voss_selfservice
will be applied.For the Administration interface, the theme with name
default
will be applied.