.. _create-theme-in-BAP:

Manage Themes in the Admin Portal and Business Admin Portal
-------------------------------------------------------------

The **Themes** interface in the Admin Portal and in the Business Admin Portal 
can be used to create a theme that applies to the Business
Admin Portal as well as to the VOSS Automate Admin Portal.

You can create a custom theme to change the following properties of
the Business Admin Portal:

* Primary and accent colors
* Logo image
* Login screen background image

  If the background image also contains logos, we recommend that these
  be placed on the bottom of the image.
* Background image for menu
* Browser tab title


.. note::

   Two themes are compiled when you add a new theme in the Business Admin Portal. For this 
   reason, it takes longer to compile themes on the Business Admin Portal than on the Admin 
   Portal. 

   Themes created in the Admin Portal or in the Business Admin Portal:
    
   * Can't be exported in full
   * Require the use of the legacy Admin Portal to include Login page text and if you 
     need to create a non-admin interface (Self-service).


Theme Previews 
...............

When creating a theme, you can use the toolbar **Preview** button to see what your theme looks like 
before assigning it to a user role, at which point it is applied to the user interface. 


Custom Theme File
..................

If you're configuring a theme for the Admin Portal (via the Business Admin 
Portal or the Admin Portal), you will need to upload a custom Admin Portal theme file. 

When using a theme file, the theme will apply to the Legacy Admin Portal. If you customize 
the theme via the **Branding** tab settings, the updates apply only to the 
Admin Portal and the Business Admin Portal. You can overwrite these updates in the legacy 
Admin Portal.  

If you do not add a theme file, then making changes to the theme via the **Branding** tab will 
apply to the legacy Admin Portal, the (new) Admin Portal, and to the Business Admin Portal. In this 
case you won't be able to upload a file theme to update the theme. 


Branding
........

.. rubric:: Color Picker
  
On the **Branding** tab in the Business Admin Portal, you can change colors via the 
color picker or by typing in the color hex value. When no colors are chosen in this tab, the 
defaults apply. 

.. rubric:: Images 

When uploading images for the theme: 

* Note the file size and *width x height* pixel dimension size restrictions. A 
  system message displays if the image is too large. 
* Only PNG files are supported for the Logo image. Other images can be PNG or JPEG. 
* The image for Menu Background does not apply to the VOSS Automate Admin Portal.
    

.. |new-bap-theme-preview-icon| image:: /src/images/new-bap-theme-preview-icon.png