.. _introduction-to-themes:

Introduction to themes
-----------------------

.. _12.5(1)|VOSSUC-20692:
.. _18.1.3|VOSSUC-20692:
.. _21.2|EKB-10106:
.. _24.1|EKB-14835:
.. _25.4|VOSS-1547:



.. tip:: 

    :ref:`use-action-search-to-navigate-automate`


Overview 
..........

Themes allow you to configure the complete look and feel of the user interface, including images, logos, colors,
fonts, sizing, and positioning. Themes can also manage login and interface header text, with the selected theme applicable to the Login page.

You can create any number of new themes and edit existing themes (with the exception of the theme name).
The VOSS Product Suite includes a default theme that serves as a baseline template for customization.

Themes are associated with user roles and are typically linked to specific customers (companies).
Theme management can be carried out through two primary methods:

* Graphical User Interface (GUI): Configure themes directly within the Admin Portal's **Themes** page
* Command Line Interface (CLI): list and show default themes per interface, download/upload theme JSON files and
  associated images as ZIP files for automation and bulk operations

Key theme concepts include:

* Default themes: System-wide default themes for Administration and Self-service interfaces are configured in system
  **System Global Settings**, providing centralized control over login page branding
* Role-based assignment: Themes can be assigned to specific user roles, with roles inheriting the system default theme when no theme is explicitly assigned
* Interface specificity: Themes can be designated for either the Admin Portal or Self-service interface
* Hierarchy visibility: Themes can be hidden from lower hierarchy levels when uploaded at specific organizational levels
* Dark mode support: Themes can optionally support dark mode with separate color and image configurations for light and dark variants
* Branding elements: Customizable components include favicons, logos (navbar, login), background images (login, menu), fonts, site titles, and navigation bar text
* Login page customization: Banner text with cookie/privacy policy placeholders can be added to login pages
* Preview functionality: Administrators can preview themes in both light and dark modes before applying them

For detailed procedures on creating and managing themes, see :ref:`create-theme-in-BAP`.



.. rubric:: Related topics 

*
    .. raw:: latex

       Theme commands in the Platform Guide

    .. raw:: html
   
       <a href="platform/concepts-theme-commands.html">Theme commands</a> 

*
    .. raw:: latex

       Manage themes in the Core Feature Guide

    .. raw:: html
   
       <a href="tasks-create-theme.html">Manage themes</a>