Pa11y CI

Open source

Pa11y CI is a command-line accessibility test runner for continuous integration that checks a list of URLs or a sitemap and reports issues.

pa11y.org
Pa11y CI homepage screenshot
GitHub stars
647
Last 30 days
+8(+1%)
Last commit
12 days ago
Repository age
10 years
Version
5.0.0
Licence
LGPL-3.0
Self-hosted
Yes

About Pa11y CI

Pa11y CI is an accessibility test runner built on Pa11y and designed for continuous integration environments. Automated testing of your application can help prevent accessibility issues from reaching production, and Pa11y CI runs those checks against a list of URLs or a sitemap and reports the issues it finds.

It is provided as the pa11y-ci command-line tool, installed globally with npm. A JSON configuration file named .pa11yci lists the URLs to visit, and paths provided on the command line can be relative, absolute or glob patterns. A defaults section sets configuration used for each test, with extra options for concurrency of parallel tests and for running in an isolated incognito browser context. A different configuration file can be selected with a command-line parameter.

It requires a stable, even-numbered Node.js release of version 20 or above. Version 4 uses Pa11y 9 with a more recent Puppeteer, which resolves a Chrome path problem that version 3 had on newer Ubuntu releases. Pa11y CI is licensed under LGPL-3.0.

Key features

  • Accessibility checks for URL lists
  • Sitemap-based testing
  • JSON configuration file
  • Parallel test concurrency
  • Incognito browser context option
  • Designed for CI pipelines

Good fit for

  • Blocking accessibility regressions in CI
  • Auditing every page of a site from its sitemap
Tags
accessibility
a11y
testing
ci
nodejs
automated-testing
sitemap

Pa11y CI: questions and answers

What is Pa11y CI used for?
Pa11y CI is a command-line accessibility test runner for continuous integration that checks a list of URLs or a sitemap and reports issues. It is a good fit for blocking accessibility regressions in CI and auditing every page of a site from its sitemap.
Is Pa11y CI open source?
Yes. Pa11y CI is open source under the LGPL-3.0 licence. Its source code is on GitHub at pa11y/pa11y-ci and is written mainly in JavaScript.
Is Pa11y CI free?
Yes. Pa11y CI is open source, so the software itself is free to use.
What are some alternatives to Pa11y CI?
Similar open-source tools in the Testing & QA category include Tox, QA Wolf CLI and Taiko. SaaS products in the same category include Codecov, Coveralls and desplega.ai.
Is Pa11y CI actively maintained?
Yes. The most recent commit to Pa11y CI was on 1 November 2026, and the latest release is 5.0.0, published on 5 October 2026. The project has 647 stars on GitHub, with 8 added in the last 30 days.

Open-source alternatives to Pa11y CI

See all

SaaS alternatives to Pa11y CI

See all