In this section · 14 articles

Customize the admin's appearance

Create an appearance with your brand colours, skin and fonts, make it the admin's default look, and style the sign-in screen.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
Permission
feature.core.appearance.create
Where
Configurations › Appearances
On this page

Before you start

  • An appearance is a saved look: brand colours, skin, density and typography. The admin's look lives in appearances, and the Theme settings panel chooses which one is the default.
  • To create an appearance you need feature.core.appearance.create. To edit one, feature.core.appearance.edit. To set the default and style the sign-in screen, feature.core.theme.edit.
  • Default Appearance is the look the installation started with. It can't be changed or deleted, because every screen falls back to it. Create your own instead.

Create an appearance

  1. Open Configurations › Appearances.
  2. Select New Appearance.
  3. On the Appearance tab, enter a Name (up to 191 characters) and, if you like, a Description (up to 500).
  4. On the Brand Colours tab, pick one of the Theme Patterns to fill the four brand colours in one click. Then fine-tune Primary Colour, Secondary Colour, Light Colour and Lighter Colour if you need to.
  5. On the Admin Appearance tab, choose the density, control size, menu colours, skin and layout options.
  6. On the Typography tab, choose the fonts, text size, weights and spacing for the whole admin.
  7. Select Save.

Tip: A language with its own typography overrides the Typography tab for people using that language.

Make it the admin's default look

  1. Open Configurations › General Settings › Theme Settings. The Theme panel opens.

  2. On the Appearance tab, choose your appearance in Appearance.

    The Theme panel on the Appearance tab, with the Appearance list open and highlighted, showing a search field and appearances starting with Default Appearance.
  3. Select Save changes.

This is the look the admin uses when nothing else chooses one. An experience can name its own appearance, and that wins for people in it. A person's own choices in their profile, such as light or dark mode, win over both.

Style the sign-in screen

  1. On the Theme panel, open the Auth Screen tab.

  2. Choose an Auth Layout: Color, Image or Slider.

  3. Choose an Auth Direction: Center, Left or Right. This sets where the sign-in form sits.

  4. Set an Auth Background Colour, or upload an Auth Background Image.

    The Theme panel on the Auth Screen tab, with Auth Layout set to Color, Auth Direction set to Center, an Auth Background Colour of #1F5E5B and an uploaded Auth Background Image.
  5. Select Save changes.

Slider needs the form on one side, so it works only with Left or Right. With Center it falls back to the colour.

Defaults on a new installation

FieldDefault
Auth LayoutColor
Auth DirectionCenter
Auth Background Colour#0b3175

What happens next

Everyone who doesn't have an experience or personal choice of their own now sees your appearance. To change an appearance later, open it from Configurations › Appearances and select Edit.