Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Customizing instance appearance

An administrator can change global CSS or system properties to alter the look and feel of the default instance interface. Functionality is not affected.

For example, organizations often use multiple instances to separate development, testing, and production activities. To help users avoid accidentally changing the wrong instance, administrators can configure each with a visually distinct theme. Several approaches are available for defining an instance theme.

CSS Properties

Navigate to System Properties > CSS.

The following properties are available through CSS Properties.

Note: Colors are specified using predefined color names, RGB decimals, or RGB hexadecimals.

  • Banner text color
  • Banner and list caption background color
  • Font used in forms and lists (this is a global font setting)
  • Button styles (background color, border color, border width, text color)
  • Field status indicator colors (including the indicators for Changed, Mandatory Populated, Mandatory Unpopulated, and Read-only)
  • List cell vertical alignment
  • Navigator menu styles (text font size, background color, text color)
  • Header font name and size
  • List and form caption color override
  • Global text search background color (both for catalog results and knowledge base results)

UI properties

Navigate to System Properties > UI Properties.

The following properties are available through UI Properties.

  • Icons used in the activity formatter
  • Background colors for Additional Comments and Work Notes
  • Button placement on forms
  • Icons used in the Task Activity formatter
  • Background colors for Incident Additional Comments and Work Notes

CSS class support

In Core UI (UI16), CSS properties and how they affect the platform UI change depending on the release.

Note: Settings configured from the Basic Configuration UI16 page are not applicable to instances with Next Experience enabled.

CSS classDescriptionHow to configure
$navpage-header-bgHeader background colorNavigate to System Properties > Basic Configuration UI16 > Header background color
$navpage-header-colorColor for header text and the global search iconNavigate to System Properties > Basic Configuration UI16 > Banner text color
$navpage-header-button-colorColor for logged in user name text, and the global search Connect, Help, and settings iconsAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$navpage-header-divider-colorHeader divider colorNavigate to System Properties > Basic Configuration UI16 > Header divider stripe color
$navpage-button-colorColor for the following icons in the sidebars- Expand/collapse - Create a conversation \(in the Connect sidebar\) - Open Connect workspaceAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$navpage-button-color-hoverColor for the following icons when a user points to the control:- Global search - Help - Settings - Clear text icon in the navigation filterAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$search-text-colorColor of the search text, both in the navigation filter and the global search fieldsAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$navpage-nav-borderBorder color for the navigation filter and the conversation filterNavigate to System Properties > Basic Configuration UI16 > Border color for UI16
$nav-highlight-mainHighlights the module after the user has clicked it. In the Connect workspace, highlights the selected conversation.Add the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$subnav-background-colorBackground for expanded navigation itemsNavigate to System Properties > Basic Configuration UI16 > Navigation background expanded items
$navpage-nav-bgHeader and footer for navigator and sidebars.Navigate to System Properties > Basic Configuration UI16 > Navigation header/footer
$navpage-nav-bg-subBackground for navigator and sidebarsNavigate to System Properties > Basic Configuration UI16 > Background for navigators and sidebars
$navpage-nav-color-subText color for modules in the main navigationAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$navpage-nav-mod-text-hoverText color when hovering over items in the main navigationNot supported
$nav-hr-colorNavigator separator colorNavigate to System Properties > Basic Configuration UI16 > Navigation separator color
$nav-highlight-bar-activeLine under the active tab in the application navigator. This color is also used as part of the theme preview on the Themes tab under system settings.Navigate to System Properties > Basic Configuration UI16 > Navigation selected tab divider bar color
$nav-highlight-bar-inactiveLine under the inactive tabs in the application navigatorNavigate to System Properties > Basic Configuration UI16 > Navigation unselected tab divider bar color
$navpage-nav-selected-bgNavigation selected tab background colorNavigate to System Properties > Basic Configuration UI16 > Navigation selected tab background color
$navpage-nav-selected-colorCurrently selected Navigation tab icon colorNavigate to System Properties > Basic Configuration UI16 > Currently selected Navigation tab color for UI16
$navpage-nav-unselected-colorUnselected navigation tab icon and favorite icons colorNavigate to System Properties > Basic Configuration UI16 > Unselected navigation tab icon and favorite icons color
$connect-latest-messageColor of the currently selected message in ConnectAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$nav-timeago-header-colorTimestamp header backgrounds in History tabNot supported
$navpage-nav-app-textCore content text color for items such as applications and the empty state text for the Connect sidebar.Add the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.
$navpage-nav-app-text-hoverText color for a selected moduleAdd the CSS property to the CSS field of a theme. For more information, see Create or customize a theme.

Parent Topic:User interface configuration