color-contrastserious
Fix color-contrast axe errors
Text does not have enough contrast against its background for many low-vision users to read it comfortably.
Affected users
Low-vision users, users with color-vision deficiencies, and people reading in bright light.
WCAG mapping
1.4.3 Contrast (Minimum) (AA)
Detection
wcagc runs axe-core in a browser context and reports contrast failures with the affected selector and WCAG mapping.
Failing markup
<button class="muted">Continue</button>Fixed code
<button class="primary">Continue</button>Sources and standards
FAQ
Does this rule cover all contrast issues?
No. It covers many text contrast failures, but images of text, gradients, disabled controls, and design intent still need manual review.
What ratio should I target?
WCAG 2.1 AA requires 4.5:1 for normal text and 3:1 for large text. Non-text UI components have a separate 3:1 requirement.
One rule rarely travels alone
Run a page through wcagc to find this rule, related WCAG issues, affected selectors, and manual checks that automation cannot judge.
Scan a page