Introduction to Themes
------------------------

.. _12.5(1)|VOSSUC-20692:
.. _18.1.3|VOSSUC-20692:
.. _21.2|EKB-10106:



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 :ref:`set_the_login_page_theme`.



Manage Themes in the legacy Admin Portal
..........................................

To manage themes in the legacy Admin Portal go to 
(default menu) **Role Management > Themes**.

|role-management-themes-legacy-gui|



Manage Themes in the Admin Portal
...................................

To manage themes in the Admin Portal (introduced at v21.2), go to (default menu) 
**Role Management > Themes**.

|role-management-themes-admin-portal|



Manage Themes in the Business Admin Portal
............................................

To manage themes in the Business Admin Portal, go to (default menu) 
**Tools > Themes**). 


|tool-themes-bap|




Related Topics
................

* 
  .. raw:: latex

     Less Files and Customizing Themes in the Advanced Configuration Guide

  .. raw:: html
  
     <a href="reference-less-files.html">Less Files and Customizing Themes</a> 

* 
  .. raw:: latex

     Manage Themes in the Legacy Admin Portal in the Core Feature Guide

  .. raw:: html
  
     <a href="manage-themes-legacy-admin-gui.html">Manage Themes in the Legacy Admin Portal</a> 

* 
  .. raw:: latex

     Create a Theme in the Admin and Business Admin Portal in the Core Feature Guide

  .. raw:: html
  
     <a href="business-admin/tasks-create-theme.html">Create a Theme in the Admin and Business Admin Portal</a>








.. |role-management-themes-admin-portal|  image:: /src/images/role-management-themes-admin-portal.png
.. |role-management-themes-legacy-gui|  image:: /src/images/role-management-themes-legacy-gui.png
.. |tool-themes-bap|  image:: /src/images/tool-themes-bap.png