How to fix aria tooltip name on Squarespace

Steps for Squarespace

1. In the Squarespace editor, navigate to the page containing the tooltip and click the block or section that generates it.
2. If the tooltip is a native Squarespace feature (e.g., form field tooltip or image caption), use the block's Content settings to add or update the label/description text — Squarespace uses this as the accessible name.
3. For custom-coded blocks (Code Block or Inject Code), go to Pages → (page) → Edit → add a Code Block, then edit the HTML to include descriptive inner text or aria-label on the tooltip element.
4. To inject a global fix, go to Settings → Advanced → Code Injection → Footer and add a small <script> that finds all role="tooltip" elements and sets their aria-label if missing.
5. Preview the page and confirm with the axe browser extension that no aria-tooltip-name violations appear.

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.