Configuration settings

Last updated on
13 April 2026

Default Admin has with a suite of exciting UI features that can be tailored to improve the user experience for a site administrator. They can also be tailored to match the branding used by an organization.

You can access these features by going to the settings section within the theme; use the ‘Settings’ button found within the Installed themes section of the page to take you there.

The settings section button to access the Gin Admin Theme

Appearance

We can change the appearance of the admin interface to suit the requirements of the end user. For example, some people might prefer dark backgrounds over light backgrounds to help with visibility and ease eye strain.

There are three modes to choose from:

  • Light
  • Dark
  • Auto

‘Light’ mode will ensure that light background colors are used in conjunction with dark foreground text, and ‘Dark’ mode ensures that dark background colors are used in conjunction with light foreground text.

Default Admin can be configured to automatically adapt to a color scheme based on a preference mode defined at the operating system level. To do this, select ‘Auto’.

Appearance settings for the Gin Admin Theme

Accent color

We can choose from a selection of predefined accent colors that will influence the color of HTML elements such as form buttons, input items, labels, select lists etc. Accent colors can be used in either Light or Dark mode.

If a color from the predefined list is not suitable then a custom color can be set by choosing the ‘transparent’ item at the end of the list and entering a HEX color reference.

Please consider your color choice carefully as it should meet a11y criteria and contrast appropriately. This tool is available to help meet your desired standard level.

Accent colors within the Gin Admin Theme

Focus color

There is the ability to change the focus color, in this section, there are several options to choose from and should be self-explanatory.

They are:

  • Default Adim Focus color (Default)
  • Green
  • Claro Green
  • Orange
  • Neutral
  • Same as Accent color
  • Custom

If you have already set an accent color you can opt to use the same color for focusing by choosing the option ‘Same as Accent color’ from the select list. If the accent color is custom, it will also match it.

The focus colour select list

A custom color can be set by choosing the ‘Custom’ option from the select list and then entering a HEX color reference. As noted with selecting an accent color, please consider a11y criteria so that it contrasts appropriately.

The custom focus color settings.

Increase contrast (EXPERIMENTAL)

There is an experimental feature to toggle high contrast mode. When enabled, this adds borders to sections of the admin area to help improve visibility. Areas that have borders applied to them are field sets, vertical toolbar menus, forms, tables, and some divisions. This feature works in both Light and Dark mode.

Dark mode

The increase contrast settings in the Gin Admin Theme using dark mode.

Light mode

The increase contrast settings in the Gin Admin Theme using light mode.

Navigation

There are three options which will change the position of the admin navigation toolbar.

  • Sidebar, Vertical Toolbar (Default)
  • Horizontal, Modern Toolbar
  • Legacy, Classic Drupal Toolbar

Sidebar, Vertical Toolbar

‘Sidebar, Vertical Toolbar’ will position the toolbar to the left-hand side of the screen. Located at the very bottom is a button that expands the menu revealing the names of the navigation items. Toggling it again will collapse the menu to just show the icons.

Vertical sidebar with settings

Horizontal, Modern Toolbar

‘Horizontal, Modern Toolbar’ positions the toolbar to the top of the screen which is fixed and always in view when the page is scrolled.

Horizontal toolbar for the Gin Admin theme

Legacy, Classic Drupal Toolbar

‘Legacy, Classic Drupal Toolbar’ uses the old-school style toolbar that is a part of Core.

Classic Drupal Toolbar showing the settings option

Layout density

Layout density is an experimental feature that will change the height of table rows in the admin area.

There are three modes:

  • Default
  • Compact
  • Narrow

The size changes are subtle but effective; selecting Default will set the row height to 62px, selecting Compact will set the row size to 52px, and Narrow will set the row height to 47px.

You can see this in effect by going to:

  • Content -> Overview

Enable form description toggle

When enabled, this feature allows a site admin to toggle the help text that can be defined in a description field for a content type. To toggle the help text simply edit a piece of content and click the question mark button.

The enable form description option in the Gin Admin Theme

A field with a description that's toggled

A field with a description appearing on the frontend.

Users can override settings

This option exposes the Default Admin theme settings to a particular user for customization.

To configure this, first make sure the setting is enabled then go to:

  • People -> Overview

Edit the user and toggle ‘Enable overrides’ in the ‘Admin theme settings’ section. This will expose a portion of the settings for further configuration.

Controls so that a user can override the Gin Admin Theme configuration

Help improve this page

Page status: No known problems

You can: