Skip to main content
Should You Run Axe-core in Your CI/CD Pipeline?Standards and Guidelines
4 min readFor Accessibility Program Managers

Should You Run Axe-core in Your CI/CD Pipeline?

The question isn't whether to use automated accessibility testing. With nearly 10 million Axe-core downloads daily, that decision's clear. The real question is where automated testing fits in your conformance program, and whether integrating it into continuous integration provides real compliance value or just the appearance of it.

Your decision depends on three factors: regulatory exposure, release velocity, and capacity for manual testing. Get this wrong, and you might ship inaccessible code with false confidence or slow delivery without reducing risk.

Key Factors That Affect Your Choice

Regulatory timeline is critical. If you're under the European Accessibility Act with enforcement underway, or operating under the DOJ Final Rule (2024) with specific WCAG 2.1 Level AA requirements, your testing must be defensible. Automated tools catch about 30-40% of WCAG violations, leaving 60-70% of your risk unseen by your pipeline.

Release cadence impacts ROI. Teams shipping multiple times daily need different testing setups than those releasing quarterly. Axe-core is great for catching regressions in fast-paced environments but isn't sufficient for establishing baseline conformance.

Manual testing capacity is key. Without accessibility specialists conducting screen reader and keyboard navigation audits, adding Axe-core to your pipeline won't fill that gap. It'll just highlight it faster.

Path A: Integrate Axe-core into CI/CD When You Have Established Baseline Conformance

Choose this path if:

  • You've completed a full manual audit against WCAG 2.1 or WCAG 2.2 Level AA
  • You have documented Partial Conformance statements for known issues
  • You release code Assistive Technology least weekly
  • You have accessibility specialists available for escalations

This high-maturity scenario uses automation to prevent regressions, not to discover your conformance status. Your pipeline blocks merges when Axe-core finds violations in components that previously passed. A green build means "no new automated violations," not "accessible."

Implementation specifics: Configure Axe-core to fail builds only for violations in WCAG success criteria you've validated manually. Exclude experimental rules. Set thresholds based on your current violation count, not zero. If you have 12 known color contrast issues documented, your pipeline should fail Assistive Technology 13, not Assistive Technology 1.

What this path doesn't do: It doesn't replace the need to test with Assistive Technology. It doesn't validate dynamic content behavior or assess cognitive load or plain language requirements under WCAG 2.2 Success Criterion 3.1.5. Manual audits are still necessary quarterly or with major feature releases.

Path B: Run Axe-core Outside CI/CD When You're Establishing Baseline

Choose this path if:

  • You haven't completed a comprehensive manual audit
  • Your team is learning WCAG for the first time
  • You're preparing for an upcoming regulatory deadline
  • You need executive visibility into your accessibility debt

This discovery scenario uses Axe-core to understand your conformance gap, not to enforce standards you haven't met. Developers run Axe-core locally or in staging environments. Your accessibility program manager aggregates results into a remediation roadmap.

Implementation specifics: Run Axe-core scans weekly against staging. Export results to your GRC platform. Categorize violations by WCAG level (A, AA, AAA) and by component ownership. Don't block deployments. You're building a backlog, not enforcing a standard.

What this path requires: A parallel track for manual testing. As Axe-core identifies automated violations, accessibility specialists validate them and find adjacent issues the tool missed. You're building toward Path A but aren't there yet.

The risk is staying in discovery mode too long. If you're running Axe-core scans for six months without remediating violations or conducting manual audits, you're collecting data, not managing risk.

Path C: Skip Axe-core Entirely When Your Risk Profile Demands Manual-First Testing

Choose this path if:

  • You're in a high-litigation sector (retail, finance, healthcare)
  • Your digital properties include complex interactive applications
  • You're subject to multiple overlapping regulations
  • You've received demand letters or consent decrees requiring specific testing methodologies

This high-stakes scenario means automated tools won't reduce your legal exposure because plaintiffs' attorneys know their limitations. Your conformance testing must be comprehensive, documented, and defensible.

Implementation specifics: Allocate budget to accessibility specialists with Certified Professional in Accessibility Core Competencies or Web Accessibility Specialist credentials. Conduct quarterly audits with screen reader testing across JAWS, NVDA, and VoiceOver. Document test procedures and results in your Accessibility Conformance Report. Use Axe-core as a supplemental check, not your primary control.

What this path costs: Manual testing is expensive and slow. A comprehensive WCAG 2.2 Level AA audit of a 50-page web application takes 80-120 hours. You're trading speed for defensibility, which is necessary when your regulatory exposure justifies it.

Summary Matrix

Factor Path A (CI/CD) Path B (Staging) Path C (Manual-First)
Baseline conformance Established In progress Required immediately
Release frequency Daily/weekly Monthly Quarterly
Manual testing capacity Ongoing Building Comprehensive
Regulatory urgency Moderate Moderate High
Primary risk Regression Unknown scope Litigation
Axe-core role Enforcement Discovery Supplemental

The 5 billion Axe-core downloads show genuine momentum, but downloads aren't conformance. Your decision isn't whether to use automated testing. It's whether your current maturity, velocity, and risk profile justify integrating it into your deployment pipeline, or if you need manual testing to address the 60% gap automation can't cover.

Choose based on where you are, not where you want to be.

You Might Also Like