How to fix image redundant alt on Magento Open Source

Remove or empty the alt attribute on images whose caption or surrounding text already describes them, so screen readers don't announce the same information twice.

Steps for Magento Open Source

  1. Follow the same steps as Adobe Commerce (Magento) above; the admin panel paths and template locations are identical in the open-source edition.
  2. After editing theme .phtml files, run: php bin/magento cache:flush and php bin/magento setup:static-content:deploy to apply changes.
Official Magento Open Source documentation ↗
<img src="red-running-shoes.jpg" alt="" />
<!-- alt="" marks image as decorative when surrounding text (e.g. an <h2>) already says "Red Running Shoes" -->

<!-- For a linked image where the anchor text already describes the link: -->
<a href="/red-running-shoes">
  <img src="red-running-shoes.jpg" alt="" />
  Red Running Shoes
</a>

What is image redundant alt?

Every image on a web page can have an "alt" attribute — a short text description that screen readers announce aloud to blind or visually impaired shoppers. The "image-redundant-alt" issue means an image's alt text says exactly (or nearly) the same thing as visible text right next to it — for example, a product photo with alt="Red Running Shoes" placed directly beneath a heading that already reads "Red Running Shoes." Screen readers end up announcing the same phrase twice in a row, which is confusing and disorienting for shoppers who rely on them.

When screen reader users hear the same text repeated back-to-back, it wastes their time and creates a disjointed, unprofessional shopping experience — making them more likely to abandon your store. Accessibility failures like this can expose your business to legal risk under laws such as the ADA (US), the Equality Act (UK), and the European Accessibility Act (EU). Google's crawlers also read alt text: redundant, repetitive alt attributes are a low-quality signal that can dilute the value of your image SEO. Fixing this is a quick win that simultaneously improves the experience for assistive-technology users, reduces legal exposure, and keeps your image metadata clean for search engines.

See the complete Image redundant alt guide for every platform and the full background.

Not sure if your Magento Open Source store has this?

Run a free SEOLZ audit — we’ll find image redundant alt and every other issue across your whole site.

Scan my site free

Fix image redundant alt on another platform