Skip to content

Set up your site colors

Add your brand colors to the Color Palette and Marketers Delight uses them for links, buttons, the header, and the block editor. When you change a palette color later, every setting linked to it changes with it.

Before you start

  • You need an Administrator account on a site running Marketers Delight 6.0 or later.
  • Have your brand colors ready as hex values, such as #C0392B.

Add your palette

  1. In WordPress, go to Theme → Settings and open the Design tab.
  2. Open Color Palette.
  3. Enter a hex value for each color you want to change, or choose one with the picker. Colors you leave alone keep the theme default. The undo icon beside a color restores its default.
  4. Select Save.

The palette has eleven colors: Background, Surface, Primary, Secondary, Tertiary, Divider, Highlight, Text Main, Text Secondary, Button, and White.

The Color Palette panel on the Design screen with eleven color fields and an Add Color button

Enter a hex value for each color, then select Save Design.

See where each color is used

Out of the box, these settings point at palette colors. Change the palette color and each of them follows.

Palette colorUsed by default for
BackgroundSite background
Text MainSite text
Text SecondaryMuted text
PrimaryLinks, header menu link hover, and links inside the content box
ButtonPrimary button background
SecondarySecondary button background
SurfaceMain background behind the content box, and the panel background
DividerContent border and panel border

Tertiary, Highlight, and White are not used by a setting until you choose them. They are always available in the color pickers and the block editor.

Add colors beyond the palette

  1. In Color Palette, select Add Color.
  2. Pick the Color and enter a Name, such as Brand Teal.
  3. Leave Key blank to use the name as the key (brand-teal), or enter your own.
  4. Select Save.
A new Additional Colors row with Color, Name, and Key fields

Each added color has a color, a name, and a key.

The key is the color's identifier in the block editor and in the helper classes below, so keep it short and unique. A key that matches a built-in color, such as primary, replaces that color.

Each color setting on the Design screen, such as those under Site Colors, Actions, Header and Navigation, Content, Sidebar, Panel, and Footer, has a menu with three sources:

  • Theme default uses the built-in value. Some settings inherit another one, and the menu says so, for example Inherits: Text.
  • Global palette links the setting to a palette color. If you change that palette color later, the setting changes too.
  • Custom color is a hex value that belongs to that setting alone. It shows Not linked to palette, so later palette changes do not affect it.
A color setting's menu open, showing Theme default, Global palette swatches, and Custom color

Choose where a setting gets its color.

Use your colors in the editor

Palette colors, including any you added, are available as presets in the block editor. The classic editor does not list them, so you add a helper class to the markup there.

Block editor

Classic editor

  1. Select a block, then open its settings in the sidebar.
  2. For text, open Typography and select Color. For a background, open Background and select Color.
  3. Pick a color under Theme. Each swatch carries the name you gave that color.
The block editor's color picker showing the site palette under Theme

Your palette appears under Theme in the block editor's color picker.

  1. Switch to the Text tab.
  2. Add a helper class to the element: <span class="has-primary-color">Highlighted words</span>.
  3. Use has-KEY-color for text, has-KEY-background-color for a background, or has-KEY-border-color for a border, replacing KEY with the color's key.

Check the result

Open your site in a new tab. Links, buttons, and the header menu should show your new colors. If a setting still shows an old color, open its menu on the Design screen. It is probably set to a Custom color, which a palette change does not affect. If nothing changed, clear your caching plugin's cache and reload.

Alex Mangini

Hi, I'm Alex! I started writing about web design and blogging at 13 years old, which turned into client work, which led to building my own software. 15 years later I'm still at it, and Marketers Delight is the epitome of my philosophy for building on the web.