> 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/check/check-computed-role.md).

# Check Computed Role

Check Computed Role compares the accessibility role on an [Element](/elements/creating-elements.md) with what you expect. Use it to catch markup changes that affect screen readers and assistive tools.

![Check computed role Test Step](https://app.does.qa/screenshots/node/check_computed_role.png)

## When to use it

* Confirm a custom control exposes the correct role after a refactor.
* Verify a dialog or menu reports `dialog` or `menu` semantics.
* Pair with [Check Computed Label](/test-steps/check/check-computed-label.md) when both role and label matter.

## Configure

### Basics

| Field               | What to set                                                   |
| ------------------- | ------------------------------------------------------------- |
| **Element**         | The [Element](/elements/creating-elements.md) to read         |
| **Comparison Type** | [Comparison Type](/test-step-options/comparison-type.md)      |
| **Value**           | Expected role as text and/or [Values](/values/value-store.md) |

### Advanced

| Field                                 | What to set                                                          |
| ------------------------------------- | -------------------------------------------------------------------- |
| **Status on fail**                    | [Failed Status](/test-step-options/failed-status.md)                 |
| **When should screenshots be taken?** | `Always` or `On Failures` (default)                                  |
| **Value Standardization**             | [Value Standardization](/test-step-options/value-standardization.md) |

## Related

* [Check Computed Label](/test-steps/check/check-computed-label.md)
* [Check Computed Style](/test-steps/check/check-computed-style.md)
* [Check](/test-steps/check.md)

**Tags:** `check`, `computed`, `role`, `test`, `expect`, `assert`, `element`, `computed`, `accessibility`