How to fix link name on Magento Open Source

Add a descriptive, screen-reader-accessible text label to every link on your store so assistive technology can announce its purpose.

Steps for Magento Open Source

  1. Follow the same steps as Adobe Commerce (Magento) above — the template structure and fix approach are identical.
  2. Create or use a custom theme under app/design/frontend/ and copy only the affected .phtml files into it before editing.
  3. Flush the cache after changes: bin/magento cache:flush.
Official Magento Open Source documentation ↗

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.

Not sure if your Magento Open Source store has this?

Run a free SEOLZ scan — we’ll find link name and every other issue across your whole site.

Scan my site free

Fix link name on another platform