﻿# UI theme and branding settings

> [HTML Version](branding.html)

In **Administration > Theme** the [administrator](360006871932.md#administrators) can:

- Choose the UI design version for BRIX.

- [Change the branding settings](#branding-settings), including corporate colors, company logos, custom fonts, and styling.

## Set the system theme

Starting with system version 2026.7, the updated **V2** interface design is enabled by default. Make sure your custom interfaces display correctly and adapt them if necessary. For details, see [Switching to Design V2 ](design-update.md).

You can switch back to the **V1** design. To do this:

1. Go to **Administration > Theme** and select a design version:

- **V1**: The previous design. You can use it until version 2026.11.

- **V2**: The current updated design with improved component styling. Similar elements use consistent colors, sizes, spacing, corner radii, fonts, and other properties. It is enabled by default.

3. Save the settings at the bottom of the **Theme** page. The system style will update for all users.

**Important**: Full migration to **V2** is scheduled for system version 2026.11. This allows a gradual transition to the new interface while keeping existing custom solutions stable.

## Customize branding options

You can align the BRIX interface with your company’s brand identity using the following settings:

1. Go to **Administration > Theme**.

2. Configure interface colors:

**(theme-02.PNG)**

- **Primary color**: Click the paint bucket icon to choose a color from the palette, or enter a specific HEX code. It contains the # symbol and a value, e.g., **#6baad8**.

- **Secondary colors**: By default, these match your primary color shade. Expand the advanced options to individually adjust panel backgrounds, navigation links, buttons, and hover effects for workspace menus.

3. Upload company logos in **.svg**, format:

**(theme-03.PNG)**

- **Logo**: Appears above the main workspace list in the top-left corner of the page.

- **Favicon**: Displays next to the page title on browser tabs.

- **Login page logo**: Appears on the sign-in screen.

- **System user avatar**: Appears next to system notifications in the main [#Activity Stream](360014162972.md) and item [associated activity stream](360014352191.md).

- **Loading screen logo**: Appears on splash screens when pages reload or update.

4. Configure fonts, page titles, help links, and custom CSS:

**(theme-04.PNG)**

- **Font files**: Upload a **.woff2** file to change the system typeface.

- **Page title suffix**: Specify your company name to display on browser tabs. Default format: **#Activity Stream · Messages · BRIX**. You can replace BRIX with any custom text.

- **Show links to Help Center**: Uncheck this box to hide all links to official BRIX documentation. This is useful for closed-network (air-gapped) environments. Disabling this option removes the **?** help widget from the top panel, widget settings, process designer, and interface designer.

- **Custom styles file**: Upload a **.css** file to apply custom styling. Starting with version 2026.4, you can define source design token values in this file to control overall UI styling. For details, see [design tokens](design-tokens.md). 

Note that applying custom CSS may affect layout stability and cause interface elements to display incorrectly.

3. Click **Save** at the bottom of the page. 

4. To return to the initial settings, click **Reset**.

By adding a custom company logo and applying a branded color scheme, your BRIX workspace may look like this:**(theme-05.PNG)**