How to fix aria valid attr value on Webflow

Audit every ARIA attribute on your pages and correct any that have invalid or mismatched values so assistive technologies can interpret them correctly.

Steps for Webflow

  1. Open the Webflow Designer and select the element flagged in the accessibility audit.
  2. In the right-hand panel, open the Element Settings (gear icon) → scroll to 'Custom Attributes'.
  3. Find the ARIA attribute with the invalid value in the custom attributes list, click it, and correct the value to the valid string.
  4. For ARIA attributes that Webflow sets automatically (e.g. on its Navbar, Tabs, or Accordion components), these are controlled by Webflow's built-in interactions — check that the component's initial state matches the ARIA value (e.g. a collapsed tab should have `aria-expanded='false'`).
  5. Publish the site and verify with the axe DevTools browser extension or Lighthouse.
Official Webflow documentation ↗
<button aria-expanded="false" aria-controls="nav-menu">Menu</button>
<nav id="nav-menu"><!-- links --></nav>

What is aria valid attr value?

ARIA (Accessible Rich Internet Applications) attributes are special HTML attributes — like `aria-label`, `aria-expanded`, `aria-describedby`, and dozens of others — that give screen readers and other assistive technologies extra information about what an element is and how it behaves. Every ARIA attribute has a strict set of allowed values defined by the ARIA specification. For example, `aria-expanded` must be `"true"` or `"false"`, and `aria-describedby` must point to a real element ID that actually exists on the page. An "invalid attribute value" means one of these attributes has been given a value that doesn't match the rules — such as a typo, a number where a true/false is expected, or a reference to an ID that doesn't exist.

When an ARIA attribute carries an invalid value, screen readers either ignore it entirely or misread the element to the user — for example, announcing a navigation menu as always collapsed, or linking a form field to a description that doesn't exist. This directly breaks the experience for blind and low-vision shoppers, which can cost you sales from that audience. More critically, WCAG 4.1.2 (Name, Role, Value) is a Level AA requirement in most jurisdictions — including the EU's EAA (enforceable from June 2025), the US ADA, and the UK's PSBAR — meaning non-compliance creates real legal exposure and risk of accessibility lawsuits. Google also evaluates accessibility signals as part of overall quality, so repeated failures can suppress organic rankings and reduce trust signals.

See the complete Aria valid attr value guide for every platform and the full background.

Not sure if your Webflow store has this?

Run a free SEOLZ scan — we’ll find aria valid attr value and every other issue across your whole site.

Scan my site free

Fix aria valid attr value on another platform