Support for WCAG 2.1 in axe-core

Marcy Sutton

By Marcy Sutton

August 20, 2018

axe core wcag2 1

Inquiring minds want to know when axe will support the Web Content Accessibility Guidelines version 2.1. In a way, it already does: WCAG 2.1 encompasses all of the 2.0 success criteria word-for-word, meaning the current axe-core ruleset targeting WCAG 2.0 now also applies to 2.1.

There are, however, 17 new Success Criteria in WCAG 2.1 items for mobile accessibility, people with low-vision, and people with cognitive and learning disabilities. In order to discuss these new criteria in terms of axe-core–an automated accessibility testing API and ruleset–we first need to talk about accessibility testing.

Automated accessibility testing vs. manual accessibility testing

The axe-core library is an automated accessibility testing tool written in JavaScript, so it’s limited by what can be detected programmatically in web browsers. For axe-core to effectively audit web pages without human assistance, accessibility issues must be detected with code that works cross-platform and without false positives.

Generally speaking, some items that can be automated for accessibility include:

  • HTML hierarchy and relationships
  • ARIA roles, states and properties: validity, relationships, and best practices
  • Color contrast (aside from limitations in browser APIs)
  • Accessible naming of form controls, links, buttons

Items that can’t be automated by axe-core and must be tested manually:

  • Error identification
  • Focus order
  • Keyboard support on custom controls (no cross-platform API for event detection)
  • Screen reader testing

In axe-core version 2.1.7 we added Needs Review results that blur the line of programmatic pass/fail, allowing users to review issues and determine whether they are truly violations or can be ignored. However, to report something for review, axe-core has to determine with some degree of certainty that it’s an accessibility issue. Otherwise, the tool would flood you with too many false positives and irrelevant issues, and you’d likely chuck your computer out the window.

Note: The axe-core JavaScript library powers our Chrome and Firefox Developer Tools extensions, so in terms of analysis, those are also considered to be automated. In contrast, our WorldSpace Assure product leverages axe-core in its internal architecture, however its purpose is guided manual testing.

Automation for WCAG 2.1

Which brings us back to WCAG 2.1: many of the new Success Criteria in WCAG 2.1 require manual testing by humans, either because the recommended techniques can’t be detected with code alone, or they’re too nuanced for a axe-core to determine a pass/fail. Some of the trickier items in WCAG 2.1 simply cannot be automated due to lack of web platform APIs.

We are actively working on new rules for the few criteria that can be automated with code, and you can follow our progress on GitHub.

Automation in axe-core depends on the tool’s ability to audit the accessibility of web pages programmatically with code, without modifying the page under test. The mantra of axe-core to limit false positives and provide realistic results is part of why it has become a testing standard. We take our users’ time and trust very seriously, so we are intentionally very thoughtful when adding new rules. You’ll see support added for WCAG 2.1 over time, as we conduct the appropriate research and testing to give you the same kind of useful results you’ve grown to depend on.

Marcy Sutton

Marcy Sutton

Marcy is a Developer Advocate at Deque Systems. She's also an #axeCore team member, @a11ySea meetup organizer & mountain enthusiast.

Get blogs in your inbox

No slop, just real accessibility insights from qualified experts.

You consent to Deque receiving, using, and sharing information as stated in Deque's privacy statement. You can change your consent at any time by contacting us.

More on this topic

EN 301 549 v4.1.1 is final! What changed, what it means, and what you should do.

Matthew Luken
September 8, 2026 By Matthew Luken

On September 2, 2026, EN 301 549 v4.1.1 was officially published. This represents a major update to Europe’s accessibility standard for ICT products and services, and it’s a big milestone. But in practice, it’s only the first step along a three-point timeline.

Read Article
Two professionals working together in an office environment, with four overlaid call-out boxes containing the terms: EN 301 549 v4.1.1, WCAG 2.2 Level AA, The European Accessibility Act (EAA), and Digital Accessibility Conformance

Test your custom elements and trust the results with Axe-core’s support for ElementInternals

wilco fiers 400x400 1 300x300
August 27, 2026 By Wilco Fiers

If you're a large enterprise organization with accessibility issues resulting from interoperability challenges, moving to ElementInternals is a savvy move. You can standardize, and safely test. And, with Axe-core now supporting ElementInternals, you can test those components and trust the results.

Read Article
A testing flow, depicting a single custom button scanned by Axe-core for React, Angular or Vue frameworks