Axe rule guides
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.

Scan the rest of the page

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