How to fix aria tooltip name on Wix

Give every tooltip element an accessible name so screen readers can announce its content to users who cannot see the screen.

Steps for Wix

  1. Open the Wix Editor for your site and click on the element that contains or triggers the tooltip.
  2. If the tooltip is a built-in Wix widget (e.g., a hover tooltip on a Wix form field), open its Settings panel — look for a 'Tooltip text' or 'Accessibility label' field and enter a clear description.
  3. If you added a custom tooltip using Velo (Wix's dev platform), open the Velo code panel and set $w('#tooltipElement').label = 'Your description'; or add the aria-label via the element's accessibility settings in the inspector.
  4. For tooltips in custom HTML iframes (Added via 'Embed Code'), edit the HTML directly to include descriptive inner text or aria-label on the role="tooltip" element.
  5. Publish your site, then test with VoiceOver or NVDA, or run the axe browser extension on the live page.
Official Wix documentation ↗

What is aria tooltip name?

An ARIA tooltip is a small pop-up element that provides extra context when a user hovers over or focuses on something — for example, an explanation next to a form field or a help icon. The `role="tooltip"` attribute tells screen readers "this element is a tooltip," but a screen reader also needs a text label (an accessible name) to actually read aloud to the user. When a tooltip has no accessible name, the screen reader announces the role but says nothing useful — or silently skips it entirely — so the information is completely hidden from blind and low-vision users.

WCAG 2.x Success Criterion 4.1.2 (Name, Role, Value) requires that every user interface component — including tooltips — has a name that assistive technology can identify. Failing this criterion means your store is inaccessible to millions of people who use screen readers, exposing you to legal risk under the ADA, Section 508, EN 301 549, and similar laws worldwide. Beyond compliance, inaccessible tooltips directly hurt conversions: if a visually impaired shopper cannot read your shipping-policy tooltip, size-guide hint, or promo-code explanation, they may abandon their cart. Search engines also crawl and index accessible text; burying information in unnamed tooltips means that content may never be indexed.

See the complete Aria tooltip name 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 tooltip name and every other issue across your whole site.

Scan my site free

Fix aria tooltip name on another platform