> 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/better-coverage/add-accessibility-checks.md).

# Add accessibility checks

Add Axe, Pa11y, Lighthouse Accessibility, and computed role or label Checks.

Accessibility Checks catch role, label, and WCAG issues in the same journey as your functional steps. Mix page-level Validators with Checks on the controls that matter most.

Use the **Flow Builder** for this walkthrough.

## Choose the right step

| Test Step                                                         | Use it to                                |
| ----------------------------------------------------------------- | ---------------------------------------- |
| [Axe](/test-steps/validator/axe.md)                               | Run a WCAG conformance scan on the page  |
| [Pa11y](/test-steps/validator/pa11y.md)                           | Run a WCAG conformance scan with Pa11y   |
| [Accessibility](/test-steps/validator/accessibility.md)           | Assert a Lighthouse accessibility score  |
| [Check computed role](/test-steps/check/check-computed-role.md)   | Assert the accessible role of an Element |
| [Check computed label](/test-steps/check/check-computed-label.md) | Assert the accessible name of an Element |

Start with [**Axe**](/test-steps/validator/axe.md) or [**Pa11y**](/test-steps/validator/pa11y.md) for a page scan. Add computed role and label Checks on buttons, links, headings, and form fields that users must understand.

## Scan the page

{% stepper %}
{% step %}

## Open the page

Start with [**Open**](/test-steps/starter/open.md). Continue with [**Touch**](/test-steps/action/touch.md) and other steps until the screen you want to audit is showing.
{% endstep %}

{% step %}

## Add Axe or Pa11y

From the [**Validator**](/test-steps/validator.md) family, add [**Axe**](/test-steps/validator/axe.md) or [**Pa11y**](/test-steps/validator/pa11y.md).

Set **Conformance Level** to the WCAG level your team expects. Axe defaults to **WCAG 2.1 - AA**.
{% endstep %}

{% step %}

## Optional: assert a Lighthouse score

Add [**Accessibility**](/test-steps/validator/accessibility.md) when you want a score threshold as well as a conformance scan.

Choose a [Comparison Type](/test-step-options/comparison-type.md) and a **Value**, such as greater than or equal to `85`.
{% endstep %}
{% endstepper %}

## Check role and label on key Elements

{% stepper %}
{% step %}

## Reach the control

Stay on the same screen, or navigate to the control with Action steps.
{% endstep %}

{% step %}

## Assert computed role

Add [**Check computed role**](/test-steps/check/check-computed-role.md).

Choose the [Element](/elements/creating-elements.md), a [Comparison Type](/test-step-options/comparison-type.md), and the expected role, such as `button` or `link`.
{% endstep %}

{% step %}

## Assert computed label

Add [**Check computed label**](/test-steps/check/check-computed-label.md) on the same or another Element. Set the expected accessible name, such as `Create account`.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Pro tip:** Put accessibility Validators after the screen is fully loaded and after any consent or overlay steps, so the scan sees the same UI a user would.
{% endhint %}

You can add [**Performance**](/test-steps/validator/performance.md), [**SEO**](/test-steps/validator/seo.md), and other Lighthouse Validators on the same screen when you want several scores in one journey. See [Test page performance](/better-coverage/test-page-performance.md) and [Test SEO](/better-coverage/test-seo.md).

## Related

* [Axe](/test-steps/validator/axe.md)
* [Pa11y](/test-steps/validator/pa11y.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)
* [Test page performance](/better-coverage/test-page-performance.md)
* [Test SEO](/better-coverage/test-seo.md)
* [Add visual checks](/better-coverage/add-visual-checks.md)
* [Choose durable selectors](/better-coverage/choose-durable-selectors.md)