Seitenreport Seitenreport
Media in Magento

Fix alt text missing in Magento

Informative and decorative images are treated separately. In Magento you check catalogue images, scrolls and theme sizes.

Catalogue images, scrolls and theme sizes

Compare image caption and gallery output of the affected Store View. An individual theme can lose existing image information during HTML output.

Check the role of the image in the product as well as the size requested by the theme. A correct original can still be loaded too large or distorted by incorrect thumbnail selection or inappropriate gallery output.

Where to check the setting in Magento

Under Images and Videos, check the scrolls of the product and the output in the active theme. Compare the file loaded in the browser with the intended role and size. Variants and Store Views may use other media or captions.

Example of this specific finding

Illustrative control case: An image explains the connection of a device but does not have an alt attribute. A purely decorative background wave, on the other hand, does not contain any additional information.

<img src="anschluss.webp" alt="Netzkabel am linken Anschluss einstecken">
<img src="dekorative-welle.svg" alt="">

follow-up audit in Magento

Test product listing, main image and zoom separately. After a variation or image change, also check the actually used cache/media URLs.

Provide a concise suitable alternative for the informative image. Decorative img elements with empty old; take into account the link function for linked images.

Derogations and scope

An empty old is intended for decorative pictures and may not be corrected as missing content.

Reference: Magento Open Source or Adobe Commerce with classic storefront. Consider store views and extensions; other storefront architectures have their own configurations.

Classify the general error

Definition, system-independent causes and further correction examples: Treat informal and decorative images separately

Configuration and test signal documentation

W3C: Task and Alternative of an Image

web.dev: Optimizing image output

Related Media Mistakes in Magento