WQI.web​qualityindex
Method v1.2.0 86 live / 86 total factors methodology

methodology / Accessibility / #56

Color contrast (WCAG AA)

#56 · Required · Web Standards · accessibility · Accessibility · weight 1.3% · impl implemented · method v1.2.0

Web Standards item — Accessibility

This factor is part of Web Standards — the table-stakes binary layer of the score. It is graded pass/fail and gates the Web Quality score; it is not weighted into Web Quality itself.

Pass criteria
Tolerant — passes on pass or warn.
Web Standards label
Sufficient color contrast
Why it's required
Body text below WCAG AA contrast is unreadable to a meaningful slice of visitors. Bar passes on no critical violations.
Same factor, two depths.

What we measure

Text needs sufficient contrast against its background to be readable for low-vision users. WCAG AA requires 4.5:1 for normal text and 3:1 for large text.

How to improve your score

Adjust foreground or background colors until you hit the ratio. Online tools like WebAIM's Contrast Checker make this trivial.

Facts

Ticket
WEBQ-56
Category
Accessibility
Status
live
Weight
1.3%
Data source
Service cost
Free — Lighthouse contrast audit
Scoring impl
implemented
Method version
v1.2.0

Implementation notes

Pull contrast violations from Lighthouse a11y audits, list affected selectors.

Scoring

Scoring formulas are versioned with the methodology. The current method (v1.2.0) maps raw measurements to pass, warn, fail. Factor weights determine how much each contributes to the composite — see the methodology index for the full table.

Cited by these standards

Standards in the Standards Library whose satisfiedBy requirement tree references this factor. Each link goes to the standard's full entry — methodology, scope, and the other factors it relies on.

Version history

Version Change Date
v1.2.0 Factor introduced. Status: live. Scoring impl: implemented. 2026-04-25

← back to methodology