WCAG fix guide

What Automated Accessibility Testing Can and Can't Catch

Last reviewed 7 min read

Applies to: all WCAG 2.2 success criteria · Automated checkers such as axe-core (which our monitor uses), WAVE and Lighthouse

Automated accessibility checkers are fast and repeatable, and they find real problems. They also miss a lot. The W3C puts it plainly: tools "cannot check all accessibility aspects automatically. Human judgement is required," and they "can not determine accessibility, they can only assist in doing so" (W3C WAI). This guide explains where the line falls, so you know what a clean scan does and doesn't tell you.

Two ways to measure "coverage"

People quote very different numbers for automated testing because they measure different things.

Both views are true at once: automated tools can find a large share of the instances of common issues, but there are whole kinds of barrier they can't see. A large share of issues still needs manual testing.

What automated tools are good at

These are mostly yes/no questions about the code, which a rules engine can answer reliably:

What automated tools can't judge (or only partly)

These need a person, because the answer depends on meaning, behaviour or context:

Automated tools can also report false or misleading results (W3C WAI), so a reported issue is worth confirming before you change working code.

What a scan only sees

Even for the checks it can run, a scan only tests what it loads:

A sensible way to combine them

  1. Run automated checks first and fix what they find. Deque reports that in its sample the top five issue categories made up over 78% of issues, and most of those were found by automated tests (Deque report).
  2. Monitor key templates (home, product or article, contact, checkout) so regressions show up.
  3. Do the manual checklist below on each template, especially after redesigns.
  4. Test with assistive technology (a screen reader, keyboard only, browser zoom) on your most important user journeys.
  5. Bring in an accessibility specialist for an audit when the stakes are high. Laws and contracts differ by country and sector; check with a lawyer about what applies to you.

What automated tools can and can't tell you: Automated checkers (including axe-core, which our monitor uses) can flag many instances of common issues, but they cannot judge everything. A human still has to check meaning and context. For scale: Deque reports that in its own sample of first-time audits, its automated tests found 57.38% of issues by volume (Deque report). That is Deque's figure for its sample, not a detection rate for any one tool, and it means a large share of issues still needs manual testing. A scan with no issues reported does not mean a page meets WCAG. Automated tests find only some accessibility issues; manual testing is still required. Not legal advice.

Manual checklist

Sources

  1. www.w3.org/TR/WCAG22/
  2. www.w3.org/WAI/test-evaluate/tools/selecting/
  3. www.deque.com/automated-accessibility-coverage-report/
  4. www.w3.org/WAI/WCAG22/Understanding/non-text-content.html
  5. www.w3.org/WAI/WCAG22/Understanding/name-role-value.html
  6. www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html
  7. www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html
  8. www.w3.org/WAI/WCAG22/Understanding/language-of-page.html
  9. www.w3.org/WAI/WCAG22/Understanding/page-titled.html
  10. www.w3.org/WAI/WCAG22/Understanding/resize-text.html
  11. www.w3.org/WAI/WCAG22/Understanding/headings-and-labels.html
  12. www.w3.org/WAI/WCAG22/Understanding/keyboard.html
  13. www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html
  14. www.w3.org/WAI/WCAG22/Understanding/focus-order.html
  15. www.w3.org/WAI/WCAG22/Understanding/focus-visible.html
  16. www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum.html
  17. www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html
  18. www.w3.org/WAI/WCAG22/Understanding/captions-prerecorded.html
  19. www.w3.org/WAI/WCAG22/Understanding/reflow.html
  20. www.w3.org/WAI/WCAG22/Understanding/error-identification.html
  21. www.w3.org/WAI/WCAG22/Understanding/status-messages.html
  22. www.w3.org/WAI/WCAG22/Understanding/accessible-authentication-minimum.html
  23. www.w3.org/WAI/WCAG22/Understanding/redundant-entry.html
  24. www.w3.org/WAI/WCAG22/Understanding/use-of-color.html

Check your own site

Run a free automated scan of one page to check it for some of the issues automated tools can find.

Run a free automated scan

Automated tests find only some accessibility issues; manual testing is still required. Not legal advice.