Skip to main content
Accessibility fix guide

Insufficient Color Contrast

Text elements do not meet WCAG 2.1 AA minimum contrast ratios (4.5:1 for normal text, 3:1 for large text). This makes content difficult or impossible to read for users with low vision.

Issue ID: A11Y-CONTRAST-001
Severity: major
Impact: High
Effort: S

Use this article when

  • You need deeper remediation guidance than the issue card can show.
  • You want CMS-specific steps before handing the fix to a developer.
  • You want a repeatable re-check path after shipping the change.
Re-run full audit

What this issue is

Text elements do not meet WCAG 2.1 AA minimum contrast ratios (4.5:1 for normal text, 3:1 for large text). This makes content difficult or impossible to read for users with low vision.

Why it matters

Text elements do not meet WCAG 2.1 AA minimum contrast ratios (4.5:1 for normal text, 3:1 for large text). This makes content difficult or impossible to read for users with low vision. This affects usability, compliance risk, and how many visitors can successfully consume the page.

How we detect it

  • FreeSiteAudit flags this issue when the rule for A11Y-CONTRAST-001 fails and the page evidence points to Dom body.
  • You can usually confirm this by checking the page source or the relevant page settings inside your CMS.

Evidence examples

Check the affected page source, rendered output, or relevant CMS setting to confirm the missing or incorrect element.

How to fix it

  1. 1Use a contrast checker tool to find failing elements
  2. 2Darken text or lighten backgrounds to meet 4.5:1 ratio
  3. 3Avoid light gray text on white backgrounds

How to re-check it

  • Run axe-core or a contrast checker and confirm all text meets WCAG AA ratios

Related tools

This issue is best verified with the full FreeSiteAudit crawl rather than a single-point mini tool.