axe-core rule: aria-valid-attr-value

ARIA attributes have invalid values

What it is

ARIA attributes carry values that are not valid for that attribute (for example aria-expanded="yes" instead of "true", or aria-labelledby pointing at an id that does not exist).

Who it blocks

Screen reader users hear missing or wrong states and labels; an aria-labelledby pointing nowhere leaves the control unnamed.

How to fix it

Use the allowed values for each ARIA attribute, and verify that every id referenced by aria-labelledby or aria-describedby exists on the page.

Example fix

<!-- Before -->
<button aria-expanded="yes" aria-labelledby="missing-id">Filters</button>

<!-- After -->
<span id="filters-label">Product filters</span>
<button aria-expanded="true" aria-labelledby="filters-label">Filters</button>

This is one of the barrier types BarrierScan checks for on every scan. Request a free accessibility scan to see whether it appears on your site, alongside the rest of the automated findings.