Configuring AWI's Appearance

{"URL":["/*.*/awa/administration_theming"],"heroDescriptionIdentifier":"ice_theming_intro","customCards":[{"id":"ice_change_colors","title":"Customizing AWI's Colors","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/AdministrationPerspective/awi_admin_awiTheming.htm","languages":["en-us"]},{"id":"ice_onprem_changelogo","title":"Customizing AWI's Logo in On-Premises Systems","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/AdministrationPerspective/awi_admin_awiTheming.htm","languages":["en-us"]},{"id":"ice_aake_changelogo","title":"Customizing AWI's Logo in AAKE Systems","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Containers/containers_ConfigureContainer.htm","languages":["en-us"]},{"id":"ice_administration_perspective","title":"Understanding the Administration Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Admin/AdministrationPerspective.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

AWI is delivered with default theme colors and a logo that you can customize. In on-prem installations you configure all these settings directly in AWI. In AAKE installations you define the color directly in AWI too but you configure the logo in a different way.

As a system administrator, you customize the AWI colors and logo in Client 0. These settings apply to all the Clients in your system.

Important: Broadcom prioritizes a culture of inclusion and diversity. AWI's default color scheme provides accessible color contrast. If you customize it, we strongly recommend that you select a color combination that provides the appropriate contrast ratio to ensure accessibility.

This page includes the following:

Customizing AWI's Colors

Follow these instructions to customize the color of the Automic Web Interface of your on-premises or AAKE system.

In the Administration perspective go to AWI Management > Theming.
In Theme Color Configuration specify the colors to be applied system-wide. You can select one of the colors provided in the dropdown lists or you can add and then select a new color:
- Theme Color
  
  Color that underlines or encircles the area or interactive UI element that is currently active. For example, the underline that indicates that a perspective is in focus, the lines that encircle a selected checkbox, button, input field, etc.
  
  AWI's Default Color is selected when you first install AWI. If you keep it, Selection Color and Text Selection Color display Autogenerate. This means that AWI automatically calculates and applies a different nuance of the default theme color to the selection and text selection colors. The autogenerated colors ensure that the resulting color contrast ratio is compliant with accessibility requirements.
- Selection Color
  
  Background color of the selected UI element.
- Text Selection Color
  
  Color of the text of the selected UI element.
- Connection Colors
  
  Users that have rights to work on different Clients can open multiple connections to the Automation Engine from within the Client that they are currently logged into. For example, as an administrators you can use this possibility to configure, maintain or monitor several Clients simultaneously.
  
  When logging in to a Client, it is possible to select a connection color. This color is used in the horizontal bar at the top of the page and in the icon in the browser tab. All windows and tabs that belong to a connection use the same color (the connection color).
  
  This field contains is the list of connection colors that the user can select by default from the Connection Color dropdown list on the log in dialog. You can extend this list by entering the hexadecimal/HTML codes for the set of colors that you want to add.

Important! You can configure AWI's theme color here or in the colors.properties configuration file. The AWI Theming page and the colors.properties file are synchronized. This means that any change on this page will be reflected in the colors.properties and vice versa.

For more information, see colors.properties - Configuring the Color Scheme.

Customizing AWI's Logo in On-Prem Systems

You can set the custom logo either through the user interface of through environment variables.

Configuring the Logo Through AWI

In Client 0, open the Administration perspective and go to AWI Management > Theming.
In Theme Logo Configuration do one the following:
- Select the Default Logo option to use the default CA Automic logo.
- Select the Custom Logo option to upload and use your own logo:
  - Click the arrow symbol.
  - Open the desired image file and confirm.
  Tip: Use a PNG file no larger than 96 px wide and 70 px high.
  With custom logos you can specify a background color logo. Select Dark or White in the drop down beside Background Color. The drop down is grayed out if you have selected the default logo option.

Configuring the Logo Using Environment Variables

Specify the image by adding and configuring one of the following variables:
- AUTOMIC_LOGO_BASE64
  
  Use this variable to set the image by providing the corresponding text in BASE64 format.
- AUTOMIC_LOGO_FILENAME
  
  Add this variable and specify the logo file name and its location.
Specify the MIME type.

Add and configure AUTOMIC_LOGO_MIMETYPE variable for image types other than .PNG.

Customizing AWI's Logo in AAKE Systems

In AAKE systems you set the logo using environment variables. For details about how to configure it, see Configuring Container-Based Systems.