How to fix link name on Squarespace

Steps for Squarespace

1. Squarespace has limited direct code access. Go to Website → Pages → click the relevant page → Edit, then locate the block containing the problematic link.
2. For image blocks used as links: click the image block → Edit → Link, then add alt text in the 'Image Alt Text' field — Squarespace uses this as the accessible name for linked images.
3. For social icon blocks: Squarespace automatically adds aria-labels to its built-in social links block based on the network name — ensure you are using the native Social Links block, not a custom code block with raw icon HTML.
4. For custom code blocks (HTML/CSS/JS): go to the block → Edit → paste your code with proper aria-label attributes on all <a> tags.
5. For header/navigation icon buttons (cart, search): go to Design → Site Styles or the header settings — Squarespace's native icons are typically labelled, but if you've added a custom icon via Code Injection (Settings → Advanced → Code Injection → Header), add aria-label to those elements.
6. Publish and test with WAVE.

What is link name?

Every clickable link on a webpage must have a meaningful text label that screen readers can announce to blind or low-vision users. A "link-name" failure means a link exists on your page but has no readable text — it might be an icon-only button (like a shopping cart or social media icon), an image link with no alt text, or an empty `<a>` tag. The WCAG 2.4.4 criterion ("Link Purpose") requires that the purpose of each link can be determined from the link text alone, or from its immediate surrounding context. Without a name, a screen reader will announce something useless like "link" or read out the raw URL instead of telling the user where the link goes or what it does.

Accessibility failures like this expose your store to legal risk under laws such as the ADA (US), AODA (Canada), EAA (EU), and Equality Act (UK) — lawsuits targeting e-commerce sites for WCAG non-compliance have increased sharply year over year. Beyond legal risk, approximately 7–8 million screen reader users in the US alone cannot navigate or purchase from a store with unnamed links, directly costing you sales. Google's crawlers also use link anchor text as a ranking signal, so unnamed links pass zero topical relevance to the pages they point to, weakening your internal linking SEO. Fixing this is typically a quick-win code change that immediately improves both accessibility compliance and search engine crawlability.

See the complete Link name guide for every platform and the full background.