Guide · Shopify
How do you check and fix color contrast on a Shopify store?
How this guide was made: Written with AI assistance and checked against the sources linked on this page.
Updated
Short answer: WCAG success criterion 1.4.3 asks for a contrast ratio of at least 4.5:1 for normal text and 3:1 for large-scale text, and 1.4.11 asks for at least 3:1 for user interface components and graphics. In Shopify you set colors in the theme editor, in color schemes under Theme settings. You can measure a pair of colors with the WebAIM contrast checker or with Chrome DevTools, change the color value in your theme on a duplicate copy, and measure again.
Check your store's homepage for accessibility issues, free. We open it like any visitor and only read the page.
Free. No email needed. It usually takes about a minute.
Want it fixed? Our AI agent fixes accessibility issues in your Shopify theme's code within 48 hours of you connecting your store, on an unpublished copy you preview and publish yourself. $390 until 30 Nov (Black Friday), then $490 one time. See the store service.
Key takeaways
- WCAG 1.4.3 (text): "at least 4.5:1", or 3:1 for large-scale text, which the W3C defines as at least 18 point, or 14 point bold.
- WCAG 1.4.11 (non-text): at least 3:1 against adjacent colors for user interface components and graphics needed to understand the content.
- Shopify's theme editor groups colors into color schemes: "A color scheme is a group of color input fields for different elements, such as backgrounds, text, and borders".
- The WebAIM contrast checker and Chrome DevTools both show a ratio for two colors.
- Text over images and non-text elements such as input borders and icons are on Shopify's own list of things to check.
- A contrast tool measures two colors. It does not tell you whether the page reads well, so look at the result on a phone and a desktop.
What do WCAG 1.4.3 and 1.4.11 require?
1.4.3 Contrast (Minimum). The W3C's text of the criterion says: "The visual presentation of text and images of text has a contrast ratio of at least 4.5:1, except for the following:" One of the exceptions is: "Large-scale text and images of large-scale text have a contrast ratio of at least 3:1;". The W3C defines large scale as "with at least 18 point or 14 point bold", and its page says text in an inactive user interface component and text that is part of a logo or brand name have no contrast requirement (W3C, Understanding 1.4.3).
1.4.11 Non-text Contrast. The W3C's text says: "The visual presentation of the following have a contrast ratio of at least 3:1 against adjacent color(s):". The list covers "Visual information required to identify user interface components and states, except for inactive components" and "Parts of graphics required to understand the content, except when a particular presentation of graphics is essential". The page adds that "any visual information necessary to indicate state, such as whether a component is selected or focused" counts, and that "User Interface Components that are not available for user interaction (e.g., a disabled control in HTML) are not required to meet contrast requirements." (W3C, Understanding 1.4.11).
Shopify's own theme accessibility page lists the same checks for a store: "The color of body text and button text has a contrast ratio of at least 4.5:1 against its background.", "The color of headings and other large text (font size 24 px and up) has a contrast ratio of at least 3:1", and "The color of non-text elements, including input borders and icons, has a contrast ratio of at least 3:1" (Shopify Help Center, Accessibility for themes).
Where are colors set in a Shopify theme?
Shopify's help page says: "You can use the theme editor to customize your online store's content, layout, typography, and colors." (Shopify Help Center, The theme editor).
Some themes group colors into color schemes. Shopify's page on color settings says: "A color scheme is a group of color input fields for different elements, such as backgrounds, text, and borders," and "Create and manage your color schemes in the Theme settings section of the theme editor". Sections then use "the Color scheme input field in sections and general theme settings to assign a color scheme to that element." (Shopify Help Center, Color settings).
So a failing pair can sit in two places: in a color scheme that several sections share, or in the section's own settings. If a color is not offered as a setting in your theme, it is written in the theme's code, which the theme code page describes.
How do you check color contrast on your store?
WebAIM contrast checker. The page says: "Enter a foreground and background color in RGB hexadecimal format or choose a color using the Color Picker." Its results show "WCAG AA:" and "WCAG AAA:" pass or fail for normal text and large text, and a separate result for graphics and user interface components. WebAIM states: "WCAG 2.0 level AA requires a contrast ratio of at least 4.5:1 for normal text and 3:1 for large text." It also states: "Large text is defined as 14 point (typically 18.66px) and bold or larger, or 18 point (typically 24px) or larger." (WebAIM, Contrast Checker).
Chrome DevTools. Chrome's documentation says to open the color picker from the text color declaration in the Elements panel, and expand the "Contrast ratio" section. It says: "To stay within the AA or AAA level, pick a color below the top or bottom line respectively." The CSS Overview panel can list "Contrast issues" under its Colors section (Chrome for Developers, Contrast).
Shopify's suggestion. Shopify's page says: "You can use an online contrast ratio tool to check the contrast of the different parts of your store." (Shopify Help Center, Accessibility for themes).
To get the two colors, open your store in your browser, pick the text with the DevTools Inspect button, and read the text color and the background color from the Styles panel. Then type the two values into the WebAIM checker.
Which spots on a Shopify store should you check?
This is our checklist of places where one color sits on another. It is not a ranking of what fails most.
- Sale badges and labels: badge text on its badge color.
- Placeholder text: the gray hint text inside the search box, email field and discount code field, against the field background.
- Buttons over images: button text on a photo or banner, and the button's own edge against the image behind it.
- Text over images: headings on slideshows, banners and videos. Shopify's page lists "The color of all text over images, including slideshows, banners, and videos, has sufficient contrast ratios" as a check.
- Input borders and icons: the borders of form fields, and icons such as the cart, search and menu, which fall under 1.4.11.
- Link text in body copy: Shopify's page also says "you can't rely on a change in color alone to differentiate a link from regular text."
- Focus and selected states: the W3C text for 1.4.11 counts visual information that shows "whether a component is selected or focused".
Check your store's homepage for accessibility issues, free. We open it like any visitor and only read the page.
Free. No email needed. It usually takes about a minute.
Want it fixed? Our AI agent fixes accessibility issues in your Shopify theme's code within 48 hours of you connecting your store, on an unpublished copy you preview and publish yourself. $390 until 30 Nov (Black Friday), then $490 one time. See the store service.
How do you fix a failing color?
- Duplicate your theme first. Shopify's page on theme code recommends that you "Duplicate your theme" before customizing (Shopify Help Center, Editing theme code).
- In the theme editor on the copy, open Theme settings and Colors, and change the failing color in its color scheme. Keep the brand color for large areas and adjust the text or button color until the pair passes.
- For text over an image, Shopify says: "In some themes, you can place a color overlay between text and an image to improve the contrast and readability of the text."
- Measure the pair again with the WebAIM checker, then look at the page on a phone and a desktop.
- If a color is set in the theme's code and not in a setting, change it there on the copy, then publish when the check passes.
FAQ
What contrast ratio does large text need?
3:1 under WCAG 1.4.3. The W3C defines large-scale text as at least 18 point, or 14 point bold. WebAIM gives the typical pixel sizes: "14 point (typically 18.66px) and bold or larger, or 18 point (typically 24px) or larger." Shopify's own page uses "font size 24 px and up".
Does a disabled button need to pass?
The W3C says: "User Interface Components that are not available for user interaction (e.g., a disabled control in HTML) are not required to meet contrast requirements." Text in an inactive component is covered by the same kind of exception under 1.4.3.
Does my logo need to pass?
The W3C's page for 1.4.3 says: "Text that is part of a logo or brand name has no contrast requirement."
Can I fix contrast without editing code?
Where your theme offers the color as a setting, yes: Shopify says you can "customize your online store's content, layout, typography, and colors" in the theme editor. Colors that are written in the theme's code need a code change.
How does VibeFix fix it?
Our AI agent fixes the accessibility issues in your Shopify theme's code within 48 hours of you connecting your store. It works on an unpublished copy of your theme, we review each change, and you preview it and publish it yourself. You get a dated before-and-after report.
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.
$390 until 30 Nov (Black Friday), then $490 one time, or $99 a month with weekly re-checks and fixes. Your $390 fix also covers the accessibility issues listed in a demand letter you received, in your theme's code. It also includes an accessibility statement draft for your store, based on the W3C template, for you to review and publish. On the $390 fix: If we can't complete your re-check, you get your money back. The free store check needs no card and no payment. Start with the free homepage check: no email needed, and your report usually appears on the page in about a minute. How it works for Shopify stores
Related: WCAG 2.2 checklist for a Shopify theme and what a Shopify accessibility audit checks.
This page is general information, not legal advice. VibeFix is independent and is not affiliated with any company named here. Shopify is a trademark of Shopify Inc. Other names are trademarks of their owners.
Want it fixed?
Our AI agent fixes accessibility issues in your Shopify theme's code within 48 hours of you connecting your store, on an unpublished copy you preview and publish yourself. $390 until 30 Nov (Black Friday), then $490 one time. See the store service.
It starts with a free check of your public homepage. No email needed.
More guides · Shopify store accessibility · About · Your privacy choices