How to fix link name on Magento Open Source

Steps for Magento Open Source

1. Follow the same template-override approach as Adobe Commerce above.
2. Locate templates under app/design/frontend/<Vendor>/<theme>/ and add aria-label or alt attributes to the relevant <a> or <img> tags.
3. Flush the Magento cache with bin/magento cache:flush after changes.
4. Verify with axe DevTools.

<a href="/collections/shoes" aria-label="Shop Women's Running Shoes">
  <!-- icon or image with no visible text -->
  <img src="shoes-banner.jpg" alt="">
</a>

<!-- OR: visually-hidden text technique -->
<a href="/pages/returns">
  <svg aria-hidden="true" focusable="false">…</svg>
  <span class="visually-hidden">View our return policy</span>
</a>

/* Visually-hidden utility class */
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

What is link name?

Every hyperlink on a webpage must have a meaningful text label that screen readers can announce to blind or low-vision users. A link's accessible name can come from the visible text inside it, an image's alt text, an `aria-label` attribute, or an `aria-labelledby` reference. When a link contains only an icon, an image with no alt text, or an empty `<a>` tag, screen readers have nothing meaningful to say — they may just announce "link" or skip it entirely. WCAG Success Criterion 2.4.4 ("Link Purpose – In Context") requires that every link's purpose can be determined from its label alone or from its surrounding context.

Links without accessible names fail WCAG 2.4.4 (Level AA), which is the legal accessibility standard referenced in the ADA, Section 508 (US), EN 301 549 (EU), and similar laws worldwide — exposing your store to demand letters, complaints, and lawsuits that are increasingly common in ecommerce. Beyond legal risk, screen-reader users (estimated at 7–8 million in the US alone) simply cannot navigate your store's menus, product cards, or checkout links, costing you real customers and revenue. Search engines also use link anchor text as a ranking signal; unnamed links are dead weight that dilutes your internal linking strategy and can suppress category and product page rankings. Fixing this issue improves accessibility, SEO, and conversion simultaneously.

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