.. _manage-themes-default-theme:

Setting the default theme
-----------------------------

.. _21.4-PB4|EKB-16004:

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:

1. 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

2. 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.
   

3. 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.

4. 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.