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

methodology / Accessibility / #54

Image alt text coverage

#54 · 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
Image alt text coverage
Why it's required
Screen-reader users can't navigate a site whose meaningful images have no alt text. Bar passes on ≥80% coverage.
Same factor, two depths.

What we measure

Every meaningful image needs alt text so screen readers can describe it. Decorative-only images use `alt=""` (empty). We measure what fraction of your images have any alt attribute at all.

How to improve your score

Add `alt="..."` to every `<img>` tag. In WordPress, set it in the media library when uploading. For decorative images, use `alt=""` explicitly.

Facts

Ticket
WEBQ-54
Category
Accessibility
Status
live
Weight
1.3%
Data source
Service cost
Free HTML parsing
Scoring impl
implemented
Method version
v1.2.0

Implementation notes

Count `<img>` tags with vs without an `alt` attribute and report the coverage ratio.

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