> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/validator/pa11y.md).

# Pa11y

Pa11y runs a WCAG conformance scan on the page during the Run. Use it when your team prefers Pa11y for page-level accessibility audits in the same journey as functional steps.

![Pa11y Test Step](https://app.does.qa/screenshots/node/validate_pa11y.png)

## When to use it

* Scan a full page for WCAG violations after the screen is loaded.
* Set **Conformance Level** to the WCAG level your team expects. The default is **AA**.
* Pair with [Accessibility](/test-steps/validator/accessibility.md) when you also want a Lighthouse score threshold.
* Add [Check computed role](/test-steps/check/check-computed-role.md) and [Check computed label](/test-steps/check/check-computed-label.md) on key controls.

For a Flow Builder walkthrough, see [Add accessibility checks](/better-coverage/add-accessibility-checks.md).

## Configure

### Basics

| Field                 | What to set                |
| --------------------- | -------------------------- |
| **Conformance Level** | `A`, `AA` (default), `AAA` |

### Advanced

| Field              | What to set                                          |
| ------------------ | ---------------------------------------------------- |
| **Status on fail** | [Failed Status](/test-step-options/failed-status.md) |

{% hint style="info" %}
**Pro tip:** [Axe](/test-steps/validator/axe.md) and Pa11y both scan the page. Pick the one your team already uses for local audits so results stay familiar.
{% endhint %}

## Related

* [Axe](/test-steps/validator/axe.md)
* [Accessibility](/test-steps/validator/accessibility.md)
* [Check computed role](/test-steps/check/check-computed-role.md)
* [Check computed label](/test-steps/check/check-computed-label.md)
* [Validator](/test-steps/validator.md)
* [Add accessibility checks](/better-coverage/add-accessibility-checks.md)

**Tags:** `validate`, `pa11y`, `test`, `expect`, `assert`, `check`, `valid`, `validator`, `accessibility`, `pally`, `pa11y`, `wcag`, `wcag2`, `conformance`, `ally`, `a11y`