Skip to main content

Hard-to-read text: how to fix "Elements must meet minimum color contrast ratio thresholds"

Published · Updated

“Elements must meet minimum color contrast ratio thresholds” is the error you’ll see in axe. Lighthouse calls it “Background and foreground colors do not have a sufficient contrast ratio”, WAVE calls it “Very low contrast”, and the Tabwise scan calls it “Text is hard to read against its background”. They all mean the same thing: some of your text is too faint.

If your text is pale grey on white, a lot of people can’t read it. Poor colour contrast is the accessibility problem we find most often. Three in four Irish business websites we tested (75% of 6,576) had text that was hard to read. It’s the most common failure worldwide too: WebAIM’s 2026 Million report found low contrast text on 83.9% of the top million homepages, up from 79.1% in 2025.

The good news: it’s usually one of the easiest fixes, often just a few colours in your theme settings.

Who this affects

Think of anyone over 60. Our eyes need more contrast as we get older. Faint text that looks fine to a 25-year-old designer can be a blur to your regular customers.

It also affects people with low vision, cataracts or colour blindness. And it affects everyone else at some point. Think of squinting at your phone on a sunny day, or with the brightness turned down to save battery.

If someone can’t read your prices, opening hours or “Add to basket” button, they’ll give up and go elsewhere.

Why it happens on so many sites

These are the usual culprits on small business websites:

  • Theme-default greys. Many themes use light grey body text because it looks clean in the demo. On a real screen it’s hard to read.
  • White text on photos. A banner with white words over a photo of your shopfront. The bright parts of the photo swallow the words.
  • Pale text inside form boxes. The faint “Enter your email” or “Search” text inside a box, which disappears for many people.
  • Brand-colour buttons. White text on a light brand colour, such as orange, lime green, pink or sky blue.

Online shops are hit hardest. In our study of Irish online shops, 81% of 2,385 had hard-to-read text. Small grey prices and pale buttons are a big part of that. Among local services, such as clinics, restaurants and salons, the figure was 70% of 5,794.

How to fix it

First, test your colours

Contrast is how much your text stands out from the colour behind it. It’s measured as a ratio. Black on white is the highest, at 21:1. Two identical colours score 1:1.

The rule for WCAG 2.1 AA, the standard most businesses work to under the European Accessibility Act, is simple:

  • Normal text needs a ratio of at least 4.5:1.
  • Large text (about 24 pixels, or about 18.7 pixels if bold) needs at least 3:1.
  • Your logo doesn’t count. There’s no contrast rule for logos.

To test a pair of colours, use the free WebAIM contrast checker. Type in your text colour and background colour, and it tells you whether they pass.

You’ll need the colour codes. These look like #767676, and you’ll find them in your theme’s colour settings. As a guide, #767676 is the lightest grey that passes on a white background. Anything paler fails.

Shopify

Your colours live in your theme settings. From your Shopify admin, go to Online Store, click Edit theme, then click the settings icon and choose Colors. Shopify’s guide to theme colour settings has the details.

Most themes use colour schemes, and different sections of your homepage can use different schemes. Check the text and button colours in every scheme you use, not just the first one.

WordPress and WooCommerce

If your theme is a newer block theme, go to Appearance, then Editor, then open Styles and choose Colors. Under Elements you can set the colour for text, links, headings and buttons across the whole site. WordPress explains this in its Styles overview.

Older themes usually keep colours under Appearance, then Customize. The exact options depend on your theme. If you use a page builder plugin, it may have its own colour settings that override the theme.

Wix

In the Wix Editor, click Site Design on the left, hover over Color & Text Theme and click Customize. Advanced Settings lets you choose the colour for each type of text. Wix’s own guide to using your colour theme recommends picking a high-contrast pairing.

Squarespace

Open the Site styles panel and click Colors, then Edit palette. Your palette’s colours are used in ten colour themes, which you apply to each section. Squarespace’s guide to changing your site’s colours covers both.

One thing to watch: changing a section’s colour theme wipes any text colours you set by hand in that section.

Text on photos

There are two good fixes, and both work on any platform:

  • Darken the photo behind the text. Many themes have an “overlay” or “opacity” setting on banner sections. Turn it up until the text is easy to read. In WordPress, the Cover block has an overlay setting.
  • Move the text off the photo. Put the words in a plain block above or below the image instead.

If the photo itself tells people something, it needs a text description too. Our guide on how to write alt text explains what to say.

Form boxes and buttons

For forms, put the label above the box (“Your email”) rather than as faint text inside it. If your theme lets you, darken the placeholder text too.

For buttons, try dark text on a light brand colour, or use a darker shade of your brand colour behind white text. Test the pair in the contrast checker either way.

Icon buttons often have a second problem: no name at all for screen readers. That’s covered in our guide to fixing buttons with no name.

If someone else built your site

Copy this and send it to your web person:

Our website’s text colours fail the WCAG 2.1 AA contrast check (success criterion 1.4.3). Can you make sure all text meets a contrast ratio of 4.5:1, or 3:1 for large text? Please include placeholder text in forms, buttons, text on photos and the footer, and send me a list of what you changed.

How to check it’s fixed

Run your colour pairs through the WebAIM contrast checker again. Then run our free scan. It checks every piece of text against the contrast rule.

Two honest limits. Our scan checks your homepage and up to four pages linked from it, so look at your other product, booking and contact pages too. And no automated tool can reliably measure text on top of a photo, so check those by eye. Open your site on your phone, step outside, and see what you can read.

For your web developer

The rule is WCAG 2.1 success criterion 1.4.3, Contrast (Minimum): 4.5:1 for normal text, 3:1 for text at least 18pt (about 24px), or 14pt (about 18.7px) bold.

  • Fix the colours at the source: theme settings, design tokens or CSS custom properties, not one-off overrides per section.
  • Check hover and focus states, and text on coloured section backgrounds, not just body text on white.
  • Placeholder text counts. Give it a colour that passes:
::placeholder {
  color: #767676;
  opacity: 1;
}
  • For text over images, add a dark layer between the image and the text, and test the lightest part of the image:
.hero { position: relative; }
.hero::before {
  content: "";
  position: absolute;
  inset: 0;
  background: rgb(0 0 0 / 0.55);
}
.hero > * { position: relative; }

Check your own website for free

We'll scan your homepage and a few key pages and email you a plain-English report in minutes.

Free Report by email in minutes Privacy