Neutral Colors

Estimated reading time: 5 min

Most colors on your site are greys, even if you never picked them. The line around an input field, the divider between footer columns, the light background behind a panel, the muted text under a product title. Rey does not hardcode these greys one by one. It builds all of them from a single color scale, and gives you two settings to steer that scale: one shifts all greys warmer or cooler at once, the other flips them for dark designs. This article explains both settings, how the scale works under the hood, and how to override it with CSS when the settings are not enough.

These options have been part of Rey since version 2.0.6, so every current version has them. They are core theme settings, not a module, and they need no extra plugin.

Where to find the Neutral Colors settings

  1. In your WordPress dashboard, open the Rey settings.
  2. Go to General, then open the Style section.
  3. Scroll past Background and Accent Colors to the Neutral Colors group.

The group describes itself as “The site’s grey tones, used for borders, dividers, inputs and light backgrounds.” That is exactly what you are editing here.

The Neutral Colors group inside General > Style, showing the Neutral Colors Hue slider and the Neutral Colors Theme dropdown.

What HSL is and why Rey uses it

Rey defines its greys in HSL, a way of writing a color with three numbers:

  • Hue is the position on a color wheel, from 0 to 360. 0 is red, 30 is orange, 120 is green, 210 is blue, and 360 wraps back to red.
  • Saturation is how colorful the color is, from 0% to 100%. At 0% there is no color at all, only pure grey. At 100% the color is fully vivid.
  • Lightness is how bright it is, from 0% (black) to 100% (white).

A grey is simply a color with very low saturation. That is the trick Rey relies on: every grey in the theme keeps its own saturation and lightness, but they all share one hue number. Change that single number and every border, divider and light background shifts together, while staying subtle because the saturation is low. With classic hex colors like #e8eaed you would have to hunt down and replace dozens of values to get the same effect.

The settings

Neutral Colors Hue

A slider from 0 to 360. The default is 210, which gives Rey’s greys their slightly cool, blue-ish cast.

Move it toward 20 to 40 and the greys turn warm, leaning beige and cream, which suits fashion, furniture or organic products. Values around 200 to 220 keep them cool and technical. A good starting point is the hue of your brand color, so the greys quietly echo it.

The change is deliberately subtle. Greys have low saturation, so the slider tints them, it does not repaint the site. The preview updates live while you drag, so watch a page with visible borders or form fields, such as the checkout.

Neutral Colors Theme

A dropdown with two choices, Light (the default) and Dark. It decides which direction the grey scale runs. On Light, level 0 is white and the scale darkens step by step to black. On Dark, the whole scale is flipped, so an element that used a near-white grey now gets a near-black one, and the greys stay readable on a dark background.

Two things to know before switching it:

  • It does not darken your site by itself. Your page background is a separate setting, the Background color at the top of this same Style section. Pick Dark here only when you are building a dark design, and set the dark background color yourself.
  • The classic Customizer preview does not apply this switch, on purpose, so the preview does not go unreadable mid-edit. Save, then check the front end in a normal browser tab.

Technically, choosing Dark adds a data-theme="dark" attribute on the site’s <html> tag, and the theme’s CSS flips the scale whenever that attribute is present.

How Rey builds the grey scale

Under the hood, the theme defines eleven CSS variables on :root, named --neutral-0 through --neutral-10. Level 0 is pure white, level 10 is pure black, and the nine steps between them are the working greys. These are the defaults with the Light theme:

VariableSaturationLightnessTypically used for
--neutral-00%100%white, page background
--neutral-117%98%faint panel backgrounds
--neutral-216%93%light backgrounds, input fills
--neutral-314%89%borders, dividers
--neutral-414%83%stronger borders
--neutral-511%71%disabled states, placeholders
--neutral-67%46%muted text, icons
--neutral-79%31%body text
--neutral-810%23%dark surfaces, default accent
--neutral-911%15%near-black backgrounds
--neutral-100%0%black, links

Notice what is missing from the table: the hue. Every row gets it from one shared variable, --neutral-hue, which is exactly what the Neutral Colors Hue slider writes. That is the whole mechanism, one number feeding eleven greys.

Notice also that the scale reaches further than “greys”. The default body text, link color and accent color are all built from it, so your hue choice quietly tints the entire design, not just the borders. Any color you set explicitly, such as a custom Accent Color or a color picked inside an Elementor widget, is independent and wins over the scale.

One practical detail matters for the CSS section below. Each variable stores only the three HSL numbers, for example --neutral-3 holds 210, 14%, 89%, not a finished color. The theme wraps it in hsl() wherever it is used. Keep that in mind when you override or reuse them.

What the –nst variable is

Look closely at how a step is defined and you will see a second shared variable:

--neutral-3: var(--neutral-hue), var(--nst, 14%), 89%;

--nst is short for neutral saturation. Every step reads its saturation from var(--nst, fallback), where the fallback is that step’s own default from the table above. The theme never sets --nst anywhere, so out of the box the fallbacks apply and each step keeps its individual saturation.

It exists as a single override knob for you. Define --nst once and all eleven steps switch to that one saturation value. There is no setting for it in the panel, it is a CSS-only lever, and the next section shows how to use it.

Three things worth knowing

  1. Neutral Colors Theme set to Dark flips the greys but leaves your background alone. A dark site needs the Background color set to a dark value too, in the same Style section. And the classic Customizer preview will not show the flip, only the saved front end will.
  2. The hue slider stays subtle by design. If you want greys that are clearly tinted, cream or blue-washed, the slider alone will not get you there. You need to raise the saturation with --nst in CSS.
  3. The scale only drives colors you have not set explicitly. Background, the Accent Colors group, and any colors chosen inside Elementor override it. If a hue change seems to do nothing on some element, that element has its own color assigned.

Example: giving a store warm, cream-toned greys

Say you sell handmade ceramics and the default cool greys feel too clinical.

  1. Open the Rey settings and go to General, then Style.
  2. Scroll to Neutral Colors and drag Neutral Colors Hue to 30.
  3. Look at the preview on a page with forms or product cards. Borders and light backgrounds now lean warm instead of blue.
  4. The effect is nice but too faint for the look you want. Add this to Settings > Additional CSS:
:root {
  --nst: 18%;
}
  1. The greys now read as soft cream and sand tones across the whole shop. Save and check a few pages, especially checkout and the cart, where inputs and borders are everywhere.

Overriding the neutral colors with CSS

When the two settings are not enough, override the variables directly. Put the CSS in Settings > Additional CSS, or in your child theme’s style.css. Never edit the parent theme, an update would erase your work.

Change hue and saturation together

Setting --neutral-hue in CSS does the same as the slider, and pairs naturally with --nst:

:root {
  --neutral-hue: 30;
  --nst: 14%;
}

Make the greys perfectly colorless

Zero saturation means the hue no longer matters at all, giving you flat, print-like greys:

:root {
  --nst: 0%;
}

Replace a single step

You can redefine one level without touching the rest. Write the three raw numbers, comma separated, without an hsl() wrapper, because the theme adds that wrapper itself:

:root {
  --neutral-2: 30, 25%, 92%;
}

Writing --neutral-2: #f5eee6; would silently break every place that step is used, since the theme would end up with hsl(#f5eee6), which is invalid.

Use the scale in your own styles

The variables are available everywhere, so your custom elements can share the theme’s greys and follow the hue slider automatically:

.my-promo-box {
  background-color: hsl(var(--neutral-1));
  border: 1px solid hsl(var(--neutral-3));
  color: hsl(var(--neutral-8));
}

For transparency, use hsla() with the alpha as a second part, for example hsla(var(--neutral-9), 0.5) for a 50% shade.

Target the dark theme only

When Neutral Colors Theme is Dark, the <html> tag carries data-theme="dark", so you can scope overrides to it:

html[data-theme="dark"] {
  --nst: 6%;
}

Put all of these snippets in Settings > Additional CSS or in the child theme’s style.css, never in the parent theme.

Was this article helpful?