DEV Community

VibeFix
VibeFix

Posted on Edited on

Faint text was the top issue on the Shopify homepages we checked: how to fix it in your theme

I'm building VibeFix.

Light grey text on a white background looks calm and modern in a design mockup. On a phone in bright sunlight, or for a visitor with low vision, it can be close to invisible.

In our study of Shopify homepages, this was the most common finding. We ran one automated, read-only check on the public homepage of 108 US Shopify stores we selected for outreach, between 5 and 11 November 2026. Faint text was on 66.7% of the stores we checked, and among the stores that had it, the median was 6 elements. Keep the limits in mind: these are stores we checked, not a random sample, and one automated check of one page. This says nothing about Shopify stores in general.

What the rule checks

The axe rule is called "color-contrast". Deque describes it like this: "All text elements must have sufficient contrast between text in the foreground and background colors behind it". It compares the colour of the text with the colour behind it and works out a ratio.

The standard behind it is WCAG Success Criterion 1.4.3, Contrast (Minimum), at Level AA. The W3C's Understanding page gives two thresholds:

  • Normal text: "The visual presentation of text and images of text has a contrast ratio of at least 4.5:1, except for the following:"
  • Large text: "Large-scale text and images of large-scale text have a contrast ratio of at least 3:1;"

"Large-scale" has a definition too: "with at least 18 point or 14 point bold". The W3C's note puts that at roughly 24px, or 18.5px in bold. The stated intent is "to provide enough contrast between text and its background, so that it can be read by people with moderately low vision or impaired contrast perception".

Places to look

I can't tell you how often each of these happens. They are simply the spots worth checking first on a store homepage:

  • The announcement bar at the very top, especially a pale text colour on a coloured strip.
  • Light grey text on white: product descriptions, small print, prices, "from" labels.
  • Text laid over a photo or a banner image, where the background changes behind the words.
  • Sale and "sold out" badges.
  • Button labels, including buttons that change colour on hover.
  • The footer: link lists, copyright lines, newsletter text.

Check a colour pair yourself

The free WebAIM Contrast Checker tests the contrast between a text colour and its background. You enter a hex value for the foreground and one for the background, or use the colour picker. It shows the contrast ratio and whether the pair passes WCAG AA for normal text, large text, and graphical objects and user interface components.

To get the hex values, use your browser's developer tools: right-click the text, choose Inspect, and read the color and background-color of the element. For text over a photo, test the lightest and darkest parts of the image behind the words. If you are unsure, ask the person who built or maintains your store to help with this step.

Fix it in your theme

First, work on a copy. Shopify's help page says: "You can duplicate your theme in your store and customize the duplicate." It also says a backup copy lets you "discard your changes and start again if you need to." The steps are in Shopify's guide to duplicating themes.

Then change the colours in the theme editor. Shopify's theme settings page explains that "Your theme's color settings control the colors used across your online store." The steps, in short:

  1. From your Shopify admin, go to Online Store.
  2. Click Edit theme next to the theme you want to customize.
  3. Click the settings icon, and then click Colors.
  4. In the Schemes section, click an existing scheme or click Add scheme.
  5. Click the colour swatch for the colour you want to change, and "enter a hex color code or choose the color from the color picker."
  6. Click Save.

Shopify describes a colour scheme as "a group of different colors, such as background, text, and button". That is useful here: a faint announcement bar can come from a scheme whose text and background are too close, so fixing the scheme can fix every section that uses it. Shopify's page covers this in its theme settings guide. Some newer themes use colour palettes instead of schemes, and that same Shopify page covers them.

A few practical habits:

  • Change one pair at a time and re-test it in the contrast checker before saving.
  • Darken the text rather than lightening the background where you can, so the design keeps its feel.
  • For text over images, a darker image, or a solid block behind the words, is easier to keep readable than a text colour tweak alone.
  • Preview the duplicate on a phone before you publish it.

Where our check fits

We built a free, automated, read-only check of a store's public homepage. Contrast is one of the things software measures well, and the report shows each faint element. For text over a photo, also check it with your own eyes. It's free, needs no email, and the report appears in about a minute.

If you'd rather not edit the theme yourself, our AI agent fixes the issues in your theme code within 48 hours of you connecting your store, on an unpublished copy you preview and publish. On our own Shopify store, our AI agent fixed all 6 issues our check found within 6 minutes of connecting, and we then confirmed every fix on phone and desktop. $490 one time, or $99 a month with weekly re-checks: vibe-fixer.com/stores.

Making faint text easier to read is one concrete step that helps visitors read your homepage.

General information, not legal advice.

Top comments (0)