.. _add_a_theme:

Add a Theme
-----------

.. _12.5(1)|VOSSUC-20692:
.. _18.1-Patch-Bundle-3|VOSS-346:


1. Prepare the theme file:

   a. Create a folder and add a file skin.css with the required name of the theme.
      The name of the folder must be the same as the intended theme name
      (only alphanumeric characters can be used, with no spaces or special characters).
   #. Add any CSS overrides to the file. Note that only the definitions as shown
      in the export of a provided CSS file ``skin.css`` can be modified.
   #. Add required image files in this folder (if any).
   #. Create a .zip archive file with the same filename as the folder.

   Refer to :ref:`download__edit_and_update_a_theme` for details.
   
#. Add the theme to the system:

   a. Choose the hierarchy level at which the theme will be created.
   #. Choose **Role Management > Themes** to open the **Themes** list view.
   #. Click **Add** on the button bar to open the **Themes** input form. Note that
      themes can only be customized by a Provider Administrator (or higher).
   #. Enter the **Theme Name** (same as the file name created above).
   #. Enter an appropriate **Site Title** if required. The site title entered here
      is the title displayed in the browser tab.
   #. Click the **Browse** button to import the created theme zip file. 
      Wait until the system displays the file chosen in the **Import File** field.
   #. If the theme must also apply to the login page, select the
      **Use this Theme to style Login page** check box. 
   #. To set login banner text and notices on the login page, refer to :ref:`set_the_login_page_theme`.
      The **Use this Theme to style Login page** check box does not have to be
      selected for banner text to show.
   #. If you want to hide the theme from lower level hierarchies, select the
      **Hide from Lower Hierarchies** check box. Users logged in at lower level
      hierarchies will not be able to see that particular theme on the **Themes**
      list view screen.  
   #. For details on the **Theme Customization** tab controls, refer to :ref:`create_theme_in_BAP`.
      .. note::
        If any details are added on this tab, *all* fields should be provided with input.
   #. Click **Save** on the button bar when complete.


.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM