Seitenreport Seitenreport
Media in Shopware

Fix alt text missing in Shopware

Informative and decorative images are treated separately. In Shopware, you check media allocation and thumbnail output.

Media assignment and thumbnail edition

Compare well-maintained media information with the specific Storefront output. An individual experience world element can leave the intended values unused.

Compare the original media with the preview images used in the storefront. Decisive is the really requested thumbnail URL in the respective layout, not only the file stored in the backend.

Where to check the setting in Shopware

Compare the media assignment of the product with the alt data and the actually selected thumbnail file. A large original is not automatically a problem if the theme loads a suitable small variant; the file requested in the browser is decisive.

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 Shopware

Check a product image in listing, detail view and on mobile devices. After changes, also consider existing image variants and their cache.

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.

Related: Shopware 6 with Storefront. Self-hosted and SaaS offer different access and configuration options; view your own headless frontends separately.

Classify the general error

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

Configuration and test signal documentation

Shopware 6: Media of the product

W3C: Task and Alternative of an Image

web.dev: Optimizing image output

Related Media Mistakes in Shopware