How to fix images missing alt on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. FOR PRODUCT IMAGES: In the Admin, go to Catalog > Products, open a product, scroll to the 'Images and Videos' section, hover over an image, and click the gear icon. Fill in the 'Alt Text' field and save the product.
2. FOR CMS PAGE/BLOCK IMAGES: Go to Content > Pages (or Blocks), open the item, click the image in the WYSIWYG editor, then click the 'Insert Image' icon in the toolbar. In the dialog, complete the 'Image Description' (alt text) field.
3. FOR BULK UPDATES: Use a product import CSV (System > Data Transfer > Import) — include the additional_images and additional_image_labels columns to set alt text for multiple products at once.
4. FOR WIDGET/BANNER IMAGES: Go to Content > Elements > Widgets or Banners, open the relevant item, edit the image properties in the WYSIWYG, and update the alt text field.

<img src="border-collie-harness.jpg" alt="Black and white Border Collie wearing a red padded harness in a sunny park">

What is images missing alt?

Alt text (short for "alternative text") is a brief written description attached to an image in your website's code. It looks like this: `<img src="dog-collar.jpg" alt="Red leather dog collar with brass buckle">`. When a browser can't display an image — or when a screen reader reads your page aloud for a visually impaired shopper — the alt text is what gets used instead. Search engines like Google also read alt text because they cannot "see" images the way humans do; it is their primary clue about what an image shows.

Google explicitly uses alt text to understand image content and to rank pages in both standard search results and Google Images — missing alt text means your product and content images are essentially invisible to search engines, costing you organic traffic. For shoppers using screen readers (a legal requirement in many markets under ADA, WCAG 2.1, and the EU Web Accessibility Directive), images without alt text create a broken experience that can expose your business to accessibility lawsuits. On product pages specifically, descriptive alt text reinforces your target keywords in context, supporting your overall on-page SEO without keyword stuffing. Fixing missing alt text is one of the fastest, highest-return SEO and accessibility improvements you can make.

See the complete Images missing alt guide for every platform and the full background.