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.

Recevez les articles de blog directement dans votre boîte mail

Pas de bavardages inutiles, mais des informations concrètes sur l'accessibilité, fournies par des experts qualifiés.

Vous acceptez que Deque , utilise et partage des informations conformément à Dequedéclaration de confidentialité. Vous pouvez modifier votre consentement à tout moment en nous contactant.

En savoir plus sur ce sujet

Pourquoi l'association de la norme EN 17161 aux WCAG constitue une avancée majeure pour l'accessibilité numérique

Wilco Fiers 400 x 400 1 300 x 300
9 juillet 2026 Par Wilco Fiers

Les WCAG constituent l'horizon. C'est la direction que vous suivez, et même si vous ne pouvez pas réellement « atteindre » cet horizon, c'est vers lui que vous roulez. La norme EN 17161 est la route sur laquelle vous roulez ; elle comporte toutes les marquages, les repères et les panneaux qui vous permettent de rester sur la bonne voie et vous empêchent de dévier vers d'autres voies ou de finir dans le fossé.

Lire l'article
Groupe de personnes dans un bureau, en train de discuter affaires autour d'un ordinateur portable. Quatre légendes superposées apparaissent sur la publication, avec les mentions suivantes : EN 17161, EN 301 549, WCAG et Loi européenne sur l'accessibilité (EAA).

Le prochain grand pas en avant en matière d'accessibilité numérique : pourquoi la communauté de l'accessibilité numérique devrait adopter la norme EN 17161

Wilco Fiers 400 x 400 1 300 x 300
11 juin 2026 Par Wilco Fiers

Découvrez comment l'intégration de la norme EN 17161 permet à votre organisation de mettre en place un programme d'accessibilité solide visant à évaluer l'accessibilité dans des conditions réelles, en complément des WCAG.

Lire l'article
Deux personnes travaillent sur un ordinateur portable ; l'une d'elles est aveugle. On distingue quatre encadrés contenant les mentions suivantes : « Conformité aux normes d'accessibilité numérique », « EN 17161 », « WCAG » et « Conception pour tous ».