What is WCAG?
WCAG stands for Web Content Accessibility Guidelines. It is the international standard for making websites usable by people with disabilities. The standard is maintained by the World Wide Web Consortium (W3C), the same body that maintains HTML and CSS.
The version your audit tests against is WCAG 2.1, published in 2018. A newer version (WCAG 2.2) was published in 2023 and adds 9 new success criteria; it does not remove or contradict anything in 2.1. WCAG 2.1 is the version most legal frameworks (in the US, the European Union, Canada, Australia, and elsewhere) currently reference.
WCAG defines about 78 testable rules called success criteria. Your audit tests the 50 of them that are at Level A and Level AA, which together represent the standard most legal requirements expect.
Why accessibility matters
Roughly 1 in 5 adults lives with a disability that can affect how they use the web. That includes people with low vision, blindness, deafness, motor impairments, and cognitive differences. An accessible site means more of them can become customers, members, students, or readers without friction.
Beyond the human case, there is a legal case. Multiple jurisdictions explicitly reference WCAG as the conformance bar:
- United States: the Americans with Disabilities Act (ADA) Title III applies to commercial websites; courts and the Department of Justice routinely cite WCAG 2.1 Level AA as the operative standard.
- European Union: the European Accessibility Act, in force since June 2025, requires WCAG-aligned accessibility for digital products and services sold into the EU market.
- Canada: the Accessible Canada Act and provincial laws (such as the Accessibility for Ontarians with Disabilities Act) reference WCAG as well.
There is also a usability case that has nothing to do with disability: many WCAG techniques (semantic markup, keyboard support, sensible color contrast, alt text on images) make sites work better on mobile, on flaky connections, and for search engines.
The 4 WCAG principles
WCAG groups its success criteria under 4 high-level principles, often abbreviated POUR: Perceivable, Operable, Understandable, Robust. Every criterion lives under exactly one principle.
1. Perceivable
Users must be able to perceive the information on the page. If you put information in an image, also put it in text. If you put information in audio, also offer a transcript. Color alone cannot carry meaning. Text needs enough contrast to read.
2. Operable
Users must be able to operate the interface. Every interactive element works with a keyboard alone, no mouse required. Time limits can be adjusted. Auto-playing media can be paused. Navigation is consistent across pages.
3. Understandable
Users must be able to understand both the content and the interface. The page declares its language. Form fields have clear labels and helpful error messages. Navigation behaves predictably; form fields do not jump the user to a new page just because they typed in them.
4. Robust
Content must be robust enough to work with a wide range of assistive technology, today and as the technology evolves. Use real semantic HTML elements (headings, buttons, lists, form labels) rather than re-implementing them with generic div and span tags. When custom widgets are needed, mark them up with the right ARIA roles, names, and states.
Level A, AA, and AAA
Each WCAG success criterion is assigned one of three conformance levels:
Comparison of WCAG conformance levels
| Level | Meaning | Where it sits in practice |
| A | Bare minimum. | Failing a Level A criterion means significant numbers of users will be entirely blocked from using your site. Hitting Level A only is below the modern bar. |
| AA | The industry and legal standard. | Most laws and procurement requirements ask for AA. This is the level your audit tests against. Aiming for AA is a reasonable, achievable target for most sites. |
| AAA | Enhanced. | Some criteria at AAA cannot be met by all content (for example, captioning every live video). The W3C explicitly states that full AAA conformance is not achievable for most sites. Pursue specific AAA criteria where they make sense; do not chase blanket AAA. |
Your audit reports against Level A and Level AA combined. Level A failures are usually the most urgent because they block the most users.
How to read your audit
The audit report has two main views.
Issues by WCAG criterion
Use this view when you want to fix a class of problem everywhere it appears. For example, if your report shows criterion 1.1.1 Non-text Content with 40 affected elements across 5 pages, that means the same kind of issue (missing alt text on images) is showing up in many places, and you can probably fix it with one change to a template or component.
Issues by page
Use this view when you want to fix one page at a time, for example if you are about to launch a new product page and want to clean it up specifically.
What to fix first
A reasonable order of attack:
- Critical impact + high element count first. These are usually missing form labels, missing button names, missing image alts, or low color contrast: simple to fix, high payoff.
- Serious impact + appears on every page. Often a navigation, header, or footer issue. One fix to the layout template propagates everywhere.
- Anything blocking checkout, sign-up, or other revenue-critical paths. Even a moderate-impact issue here is more urgent than a critical issue on a buried marketing page.
The LLM prompt feature
Each violation in the report includes a copy-paste prompt you can paste into Claude or ChatGPT. The prompt gives the model the violation, the offending HTML, and the WCAG criterion, then asks it to ask you which web framework you use before producing fix code. This means you do not need to manually translate generic accessibility advice into your stack; the model does it. The model will also explain the change and suggest how to verify it.
What axe-core catches and what it misses
Your audit uses an open-source rule engine called axe-core. axe-core is the industry standard for automated accessibility testing, and it is honest about its limits: it catches roughly 30 to 40 percent of WCAG issues automatically. The remaining 60 to 70 percent need a human.
Things axe catches well
- Missing alt attributes on images
- Insufficient color contrast (most cases)
- Form fields without labels
- Buttons and links without accessible names
- Invalid or misused ARIA attributes
- Missing language declarations
- Markup mistakes that break assistive technology, such as duplicate IDs or nested interactive controls
Things axe cannot catch
- Whether an alt attribute, even when present, actually describes the image meaningfully (alt="image" is technically present but useless)
- Whether link text like "click here" makes sense in context
- Whether form error messages are actually clear enough for a non-technical user
- Whether the heading hierarchy reflects the logical structure of the content
- Whether a custom widget actually works with a screen reader, not just whether it has the right ARIA attributes
- Whether the focus order matches the visual reading order in complex layouts
For these, you need the manual testing described in the next section.
Manual testing you should still do
After working through the violations in your audit, do at least these manual checks:
- Tab through every page using only the keyboard. Confirm every interactive element is reachable, focus is always visible, and you can never get stuck on an element with no way out.
- Listen to your site with a screen reader. On macOS or iOS, turn on VoiceOver (Command + F5 on Mac). On Windows, NVDA is free. On both platforms, listen to your home page top to bottom and confirm what is announced makes sense.
- Zoom your text to 200 percent. Use your browser's zoom (Command-plus or Control-plus). Confirm no content is lost or hidden, and that nothing requires horizontal scrolling on a normal-width window.
- Audit color combinations the scanner could not test. Use the WebAIM Contrast Checker on any color pair the scanner flagged as "incomplete" or that you used in custom graphics.
- Check images that look meaningful. For each image with non-empty alt text, ask: does the alt text describe what the image actually shows in a way that makes sense in context, or is it a generic filler?
- Check forms. Submit them with bad data on purpose and confirm the error messages tell the user what to do, not just what is wrong.
Glossary: all 50 WCAG 2.1 Level A and AA criteria
Every criterion your audit can flag is listed here, grouped by principle. Each links to the official W3C explanation. The plain-English description is what the criterion requires; for examples and edge cases, follow the W3C link.
Further reading and tools
Free official references
Free testing tools