How to fix aria tooltip name on WooCommerce

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

Steps for WooCommerce

  1. In WordPress admin, go to Appearance → Theme File Editor (or use a child theme and edit via FTP/SFTP).
  2. Search all theme PHP/HTML template files for role="tooltip" — common locations: woocommerce/templates/, your theme's inc/ folder, and any custom shortcode output.
  3. Edit the template to wrap tooltip content in descriptive text, or add aria-label="[description]" to the tooltip element.
  4. If the tooltip is from a plugin (e.g., WooCommerce Product Add-Ons, WPForms), check the plugin's settings for an accessibility label field, or use a Custom CSS/JS plugin to inject aria-label via JavaScript as a temporary fix.
  5. Install the free axe DevTools browser extension, reload the affected page, and run a scan to confirm the violation is resolved.
Official WooCommerce 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 WooCommerce 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