Seitenreport Seitenreport
Medien in Shopware

Alt-Text fehlt in Shopware beheben

Informative und dekorative Bilder getrennt behandeln. In Shopware prüfen Sie dafür Medienzuordnung und Thumbnail-Ausgabe.

Medienzuordnung und Thumbnail-Ausgabe

Vergleichen Sie gepflegte Medieninformationen mit der konkreten Storefront-Ausgabe. Ein individuelles Erlebniswelten-Element kann die vorgesehenen Werte ungenutzt lassen.

Vergleichen Sie das Originalmedium mit den in der Storefront verwendeten Vorschaubildern. Entscheidend ist die wirklich angeforderte Thumbnail-URL im jeweiligen Layout, nicht nur die im Backend hinterlegte Datei.

Wo Sie die Einstellung in Shopware prüfen

Vergleichen Sie die Medienzuordnung des Produkts mit den Alt-Angaben und der tatsächlich gewählten Thumbnail-Datei. Ein großes Original ist nicht automatisch ein Problem, wenn das Theme eine passende kleine Variante lädt; maßgeblich ist die im Browser angeforderte Datei.

Beispiel für diesen konkreten Befund

Illustrativer Kontrollfall: Ein Bild erklärt den Anschluss eines Geräts, besitzt aber kein alt-Attribut. Eine rein dekorative Hintergrundwelle enthält dagegen keine zusätzliche Information.

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

Nachprüfung in Shopware

Ein Produktbild in Listing, Detailansicht und auf Mobilgeräten prüfen. Nach Änderungen auch bestehende Bildvarianten und deren Cache berücksichtigen.

Für das informative Bild eine knappe passende Alternative bereitstellen. Dekorative img-Elemente mit leerem alt kennzeichnen; bei verlinkten Bildern die Linkfunktion berücksichtigen.

Ausnahmen und Geltungsbereich

Ein leeres alt ist bei dekorativen Bildern beabsichtigt und darf nicht pauschal als fehlender Inhalt korrigiert werden.

Bezug: Shopware 6 mit Storefront. Self-hosted und SaaS bieten unterschiedliche Zugriffs- und Konfigurationsmöglichkeiten; eigene Headless-Frontends getrennt betrachten.

Den allgemeinen Fehler einordnen

Definition, systemunabhängige Ursachen und weitere Korrekturbeispiele: Informative und dekorative Bilder getrennt behandeln

Dokumentation zur Konfiguration und zum Prüfsignal

Shopware 6: Medien des Produkts

W3C: Aufgabe und Alternative eines Bildes

web.dev: Bildausgabe optimieren

Verwandte Medien-Fehler in Shopware