Seitenreport Seitenreport
Medien in Magento

Alt-Text fehlt in Magento beheben

Informative und dekorative Bilder getrennt behandeln. In Magento prüfen Sie dafür Katalogbilder, Bildrollen und Theme-Größen.

Katalogbilder, Bildrollen und Theme-Größen

Vergleichen Sie Bildbeschriftung und Galerie-Ausgabe der betroffenen Store View. Ein individuelles Theme kann vorhandene Bildinformationen bei der HTML-Ausgabe verlieren.

Prüfen Sie die Rolle des Bildes im Produkt sowie die vom Theme angeforderte Größe. Ein korrektes Original kann durch falsche Thumbnail-Auswahl oder unpassende Galerie-Ausgabe dennoch zu groß oder verzerrt geladen werden.

Wo Sie die Einstellung in Magento prüfen

Prüfen Sie unter Images and Videos die Bildrollen des Produkts und die Ausgabe im aktiven Theme. Vergleichen Sie die im Browser geladene Datei mit der vorgesehenen Rolle und Größe. Varianten und Store Views können andere Medien oder Beschriftungen verwenden.

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 Magento

Produktlisting, Hauptbild und Zoom getrennt testen. Nach einer Varianten- oder Bildänderung auch die tatsächlich verwendeten Cache-/Medien-URLs prüfen.

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: Magento Open Source beziehungsweise Adobe Commerce mit klassischer Storefront. Store Views und Erweiterungen berücksichtigen; andere Storefront-Architekturen haben eigene Konfigurationen.

Den allgemeinen Fehler einordnen

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

Dokumentation zur Konfiguration und zum Prüfsignal

W3C: Aufgabe und Alternative eines Bildes

web.dev: Bildausgabe optimieren

Verwandte Medien-Fehler in Magento