How to fix aria tooltip name on Webflow

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

Steps for Webflow

  1. Open your project in the Webflow Designer and locate the element with role="tooltip" in the Navigator panel.
  2. Select the element, open the Element Settings panel (the gear icon), and scroll to the Custom Attributes section.
  3. If the tooltip contains inner text, verify that text is descriptive. If not, add a custom attribute: Name = aria-label, Value = your plain-language tooltip description.
  4. If the tooltip is dynamically bound to a CMS collection, use the CMS binding button next to the aria-label value field to pull the description from a CMS field.
  5. Publish the site and run the axe DevTools browser extension on the live URL to confirm the fix.
Official Webflow 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 Webflow 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