Skip to content
ShopifyRule: color-contrast•Reviewed Oct 2026

Fix color contrast ratios for text in Shopify themes

Text and interactive controls must have at least 4.5:1 contrast against their background (3:1 for large text).

What's wrong

Light gray text, subtle subheadings, or low-contrast button states fail WCAG 1.4.3 minimum contrast requirements.

Who it affects

People with low vision, color vision deficiency, and customers using devices in direct sunlight or dim environments cannot read critical store information.

How to fix on Shopify

Adjust color tokens in `config/settings_schema.json` and CSS custom properties in `assets/base.css` to guarantee a 4.5:1 ratio for body text against backgrounds.

Code example

Problematic Code
CSS
.product-card__price {
  color: #999999; /* 2.8:1 on white - FAILS */
}
Recommended Accessible Code
CSS
.product-card__price {
  color: #595959; /* 4.6:1 on white - PASSES WCAG AA */
}

How to check your fix

Use Chrome DevTools color picker to inspect element contrast. Confirm the contrast badge displays a green checkmark indicating ≥ 4.5:1 ratio.

Check if your site has this issue

Scan any public store page free against WCAG 2.2 AA in 30 seconds.

Your session has ended

Sign in again to carry on. Anything you typed on this page is kept.

Signed in another way? Use another method (opens a new tab)