Getting Started
Use the free A11y Scan Chrome extension to inspect a page, review findings, and build a repeatable JSON scan profile.
1. Install A11y Scan
Install the free extension from the Chrome Web Store ↗. After Chrome adds it, pin A11y Scan from the Extensions menu and open its side panel on a page you can inspect.
Build and load a team preview
- Get the project source from the team and install its dependencies with
pnpm installin thecodedirectory. - Run
pnpm --filter @a11yscan/extension build. - Open
chrome://extensions, turn on Developer mode, choose Load unpacked, and selectcode/packages/extension/dist.
2. Scan and inspect a page
Open the extension side panel on a page you can inspect. In Scan, choose the WCAG version and level, then run a single-page scan. Review findings and affected elements in Results. Automated checks help find issues; a complete accessibility review still needs human judgment.
The Screen Reader and Keyboard tabs provide assisted reading-order and tab-order inspection. They are browser aids, not a substitute for testing with assistive technology. Use on-page highlights to locate findings. The color-vision preview is a simulation.
3. Save a repeatable scan profile
Scan settings form a versioned JSON configuration. Use the free profile builder to choose a target and supported settings, download the JSON, and import it into the extension. Review the effective configuration before running a scan. The builder marks settings that the current executor cannot use.
You can scan one page, crawl same-origin links or an explicit URL list, and use supported viewport and Scan Movie settings. Some combinations are disabled in the extension. Scan Movie visually walks focusable elements after a scan; it does not create additional findings.
4. Export and discuss results
Export JSON for a portable record. Single-page results also offer HTML and print-to-PDF output. When Chrome’s built-in AI model is available, the AI Chat tab can discuss a bounded summary of the current scan and point back to findings. If the model is unavailable, the tab says so; no cloud AI service is required.