Manage Themes (Admin Portal and Business Admin Portal)¶
Overview¶
The Themes page 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.
Note
To access the Themes page in the Admin Portal, go to (default menus) Role Management > Themes.
To access the Themes page in the Business Admin Portal, go to (default menus) Tools > Themes.
You can select the following tabs on the Themes page in the Admin Portal:
Theme Details
Branding
Login Page Details
Custom Themes¶
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).
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 don’t add a theme file, 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.
Preview a Theme¶
When creating a theme, you can use the toolbar Preview icon 
to see what your theme looks like
before assigning it to a user role. Once you assign a theme to a user role it is applied to the GUI.
Theme Details Tab¶
On the Theme Details tab of the Themes page you specify theme details:
Provide a theme name and a description
Specify navigation bar text
Define whether to use the theme to style the Login page
Define whether to hide the theme from lower hierarchies
Specify the site title
Upload a custom theme file, if applicable
Enable or disable backups
Define the GUI where the theme is applied
Branding Tab¶
On the Branding tab (in the Admin Portal or 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.
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.
For image filenames, you can use the following characters and character types:
ALPHA / DIGIT / "-" / "." / "_" / "~"/ "#"
Image details:
Favicon: The favicon for the site. Shown on the tab and when the site is bookmarked.
Type: PNG image or with
.icoextension.Maximum dimensions: 256x256 pixels.
Logo: This image is used for the logo in the top left of the menu bar.
Type: PNG image with a transparent background.
Maximum file size: 0.5MB
Maximum dimensions: 600 pixels in width and 192 pixels in height.
Login Logo: This image is used for the logo on the login page.
Type: PNG image with a transparent background.
Maximum file size: 0.5MB
Maximum dimensions: 600 pixels in width and 192 pixels in height.
Login Background: This image is used for the login screen background.
Type: PNG or JPEG image.
Maximum file size: 5MB
Maximum dimensions are 1920 pixels in width and 1080 pixels in height.
Menu Background: This image is used for the side menu background.
Type: PNG or JPEG image.
Maximum file size: 2MB
Maximum dimensions: 240 pixels in width and 1040 pixels in height.
Login Page Details Tab¶
The Login Page Details tab defines the theme for the Login page, including the title and banner text, cookie policy and privacy policy details.
