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 theme
  
  https://instance/login/?theme=ABC - Login page will show use ABC theme
- Admin Portal (introduced at v21.2):
  
  https://instance/portal/#/admin - Login page will show use XYZ theme
  
  https://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 name customer1 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.