How to fix seo product image alt filename on Magento Open Source

Replace filename-based alt text on product images with short, descriptive phrases that accurately describe each image's content.

Steps for Magento Open Source

  1. Follow the same steps as Adobe Commerce above.
  2. Navigate to Catalog → Products → open a product → Images and Videos tab.
  3. Click each image thumbnail and fill in the 'Alt Text' field.
  4. Save the product.
  5. For bulk operations, use a data-patch script or a community extension to update image labels (alt text) across multiple products efficiently.
Official Magento Open Source documentation ↗
<img src="red-merino-wool-hoodie.jpg" alt="Red merino wool zip-up hoodie, front view">

What is seo product image alt filename?

Every image on a webpage has an "alt" attribute — a short text description that lives in the HTML code. When a product image is uploaded without a custom alt text, most platforms automatically fill it in with the image's filename (e.g., `IMG_4821.jpg` or `product-blue-v2_FINAL.png`). This filename tells search engines and visually-impaired shoppers absolutely nothing useful about what's actually in the photo. Descriptive alt text, by contrast, reads like a caption: "Blue cotton crew-neck sweater, front view."

Google explicitly uses alt text to understand and rank images in Google Images search, which drives meaningful, purchase-ready traffic to product pages. Filename-based alt text wastes this ranking signal entirely — a competitor with a well-written alt text will outrank you for visual searches on the same product. Beyond SEO, alt text is a legal accessibility requirement in many jurisdictions (ADA, EN 301 549, WCAG 2.1): missing or meaningless alt text can expose your store to accessibility complaints and lawsuits. Fixing it is one of the highest-ROI, lowest-effort on-page SEO tasks available to a store owner.

See the complete Seo product image alt filename 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 seo product image alt filename and every other issue across your whole site.

Scan my site free

Fix seo product image alt filename on another platform