How to fix aria tooltip name on Wix

Add a visible, descriptive text label to every element that has role="tooltip" so screen readers can announce its purpose.

Steps for Wix

  1. Open the Wix Editor and click on the element that triggers or contains the tooltip.
  2. In Wix, built-in tooltips on buttons or icons often have a 'Tooltip' text field in the element's Settings panel (click the element → Settings gear icon → look for 'Tooltip' or 'Accessible label').
  3. For custom-coded tooltips added via Wix Velo (formerly Corvid), open the page's code panel and locate the tooltip element. Add an aria-label property: $w('#myTooltip').setAttribute('aria-label', 'Add to wishlist');
  4. If you added a tooltip widget from the Wix App Market, check that app's settings panel for a label or accessibility text field.
  5. Use Wix's built-in Accessibility Wizard (Settings → Accessibility Wizard) to scan for missing labels after making changes.
  6. Preview and test with a screen reader to confirm the tooltip text is announced.
Official Wix documentation ↗
<div role="tooltip" id="wishlist-tip" aria-label="Add to wishlist">
  Add to wishlist
</div>

<!-- OR using aria-labelledby -->
<div role="tooltip" id="shipping-tip" aria-labelledby="shipping-tip-text">
  <span id="shipping-tip-text">Free shipping on orders over $50</span>
</div>

What is aria tooltip name?

A tooltip is a small pop-up element that appears when a user hovers over or focuses on something — think of the little "Add to wishlist" bubble that appears when you hover over a heart icon. In HTML, these are built using `role="tooltip"`. The problem flagged here (WCAG 4.1.2) is that your tooltip element has no accessible name — in other words, the tooltip contains no text (or the text is hidden from assistive technology), so a screen reader has nothing to read aloud. An accessible name is simply the label a screen reader announces when it reaches that element.

Screen-reader users — who may be blind, have low vision, or rely on keyboard-only navigation — depend entirely on accessible names to understand what a tooltip communicates. Without one, the tooltip is completely silent: the user either hears nothing or hears a meaningless "tooltip" announcement with no content. This is a direct failure of WCAG 2.1 Success Criterion 4.1.2 (Name, Role, Value), which is a Level AA requirement that governs legal accessibility compliance in the US (ADA), EU (EAA), UK (PSBAR), and many other jurisdictions. Inaccessible tooltips create real legal exposure for your business and exclude a significant portion of potential customers. Fixing them improves trust, usability, and demonstrates commitment to inclusive commerce.

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 audit — 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