Storybook Accessibility Tests
storybook.js.org
- Free plan
- Web
What Storybook Accessibility Tests is
Storybook Accessibility Tests is the free web Accessibility addon for checking UI components in Storybook stories. It audits each story’s rendered DOM against heuristics drawn from WCAG rules and other accepted accessibility practices, using Deque’s axe-core library. Storybook says axe-core can automatically catch up to 57% of WCAG issues. The Accessibility panel separates findings into violations, passes, and incomplete checks that need manual confirmation. Default rules cover WCAG 2.0 and 2.1 Level A and AA guidance plus best practices. A toolbar control simulates different vision impairments. Teams can configure the DOM context, axe settings, options, and individual rules. Integration with Storybook’s Vitest addon lets accessibility checks run beside component tests in Storybook and CI. The `a11y.test` setting supports `off`, `todo`, and `error`, with `error` required for CI failures. Asynchronous rendering can cause checks to run before final output and produce false negatives.
Who it suits
It suits developers checking UI component accessibility in Storybook stories, including teams running component tests in CI. Manual reviewers remain important for incomplete checks and asynchronous components.
Good to know, and what to watch
- Free addon for Storybook accessibility checks
- Uses axe-core against rendered story DOM
- Separates violations, passes, and incomplete results
- Vision-impairment simulation toolbar
- Vitest and CI integration
- Some checks require manual confirmation
- Async rendering may cause false negatives
- Automated checks catch only part of WCAG issues
Plans
Every plan and priceChromatic Enterprise
Chromatic Free
Storybook Accessibility addon
Chromatic Starter
Free plan
The verdict
Storybook Accessibility Tests provides a free first pass over component accessibility, with configurable rules and clear result categories. It works best alongside human review, especially for incomplete checks or asynchronously rendered components.
What the maker publishes
- Addon availability
- Storybook lists Accessibility Storybook Addon A11y under popular addons and describes it as testing UI component compliance with WCAG web accessibility standards. source
- Async rendering limitation
- For asynchronous components such as those using Suspense or React Server Components, checks can run before final rendering and produce false negatives. source
- Configuration
- Users can configure the DOM context, axe settings and options, and individual rules for accessibility checks. source
- Engine
- The addon is built on Deque’s axe-core library, which Storybook says automatically catches up to 57% of WCAG issues. source
- Manual review limit
- Some checks are incomplete and require manual confirmation, and Storybook describes automated checks as a first line of QA for blatant violations. source
- Purpose
- The Accessibility addon audits a story’s rendered DOM against heuristics based on WCAG rules and other accepted accessibility practices. source
- Results
- The Accessibility panel separates results into violations, passes, and incomplete checks that need manual confirmation. source
- Rulesets
- By default, checks use rules based on WCAG 2.0 and 2.1 Level A and AA guidelines plus best practices. source
- Test behavior
- The `a11y.test` setting supports `off`, `todo`, and `error`; CI errors require the setting to be `error`. source
- Vision simulation
- The addon adds a toolbar button to simulate different vision impairments. source
- Vitest integration
- The Accessibility addon integrates with the Vitest addon so accessibility checks can run alongside component tests in Storybook and CI. source
- Who it is for
- Storybook presents accessibility testing as a way to check the accessibility of UI components in stories. source
Checked against the maker's pages on 4 Oct 2026.