How to fix aria roles on Wix

Audit every element that has a `role` attribute and replace any invalid or misspelled role value with a valid WAI-ARIA role from the official specification.

Steps for Wix

  1. Wix does not expose raw HTML editing for most site elements; however, custom HTML can be injected via the HTML iframe widget (Add → Embed → Custom Code or HTML iFrame).
  2. If the invalid role is inside a custom HTML/embed block: open the HTML iFrame in the Wix Editor, click Enter Code, and correct or remove the `role` attribute.
  3. For roles added by Wix's own components, report the issue to Wix Support — you cannot directly edit core component markup.
  4. If you are using Wix Studio (Velo / Wix Studio advanced mode), open the relevant page, switch to Developer Mode, and edit the component properties in the Properties & Events panel or in Page Code to remove/correct the role.
  5. After updating, republish the site and recheck with axe DevTools.
Official Wix documentation ↗

What is aria roles?

The `role` attribute tells assistive technologies (screen readers, braille displays, voice control software) what kind of interface element something is — for example, a button, a navigation landmark, a dialog, or a list. The WAI-ARIA specification defines an exact list of allowed role names. If any element on your store carries a role that isn't on that list — whether it's a typo like `role="buton"`, an invented name like `role="product-card"`, or an outdated value like `role="presentation"` used incorrectly — the browser and screen reader simply ignore it or misinterpret the element entirely. WCAG Success Criterion 4.1.2 (Name, Role, Value) requires that every user interface component exposes a valid, programmatically determinable role so all users can understand and operate it.

Screen reader users — who include people with visual impairments, motor disabilities, and cognitive disabilities — rely on role information to navigate and interact with your store. An invalid role means those customers hear confusing or missing announcements, cannot identify interactive controls, and may abandon your checkout or product pages. Beyond lost conversions, accessibility failures carry real legal risk: WCAG 2.1 AA compliance is referenced in ADA Title III lawsuits and, in many jurisdictions, is a statutory requirement for online businesses. Google also uses accessibility signals as a quality factor, so pages riddled with invalid ARIA can indirectly suppress organic rankings. Fixing invalid roles is typically a quick code change with outsized impact on both compliance and customer experience.

See the complete Aria roles guide for every platform and the full background.

Not sure if your Wix store has this?

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

Scan my site free

Fix aria roles on another platform