Seitenreport Seitenreport
Medien in WordPress

Alt-Text fehlt in WordPress beheben

Informative und dekorative Bilder getrennt behandeln. In WordPress prüfen Sie dafür Medienbibliothek und konkrete Bildinstanz.

Medienbibliothek und konkrete Bildinstanz

Der Alternativtext in der Mediathek und der tatsächlich gespeicherte Bildblock können voneinander abweichen. Prüfen Sie das veröffentlichte Element nach der Änderung erneut.

Der Alt-Text in der Medienbibliothek muss nicht der einzige Wert sein: Ein Block oder Builder kann einen eigenen Text und eine eigene Bildgröße speichern. Untersuchen Sie deshalb das verwendete Bild im Beitrag und die ausgelieferte img-Ausgabe.

Wo Sie die Einstellung in WordPress prüfen

Wählen Sie die konkrete Bildinstanz im Beitrag aus und vergleichen Sie deren Alt-Text mit dem Datensatz in der Mediathek. Bei eigener PHP-Ausgabe kann wp_get_attachment_image Größen und responsive Quellen liefern; ein hart codiertes img-Tag nutzt diese Ausgabe nicht automatisch.

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 WordPress

Nach der Korrektur Bild-URL, Alternativtext und ausgewählte responsive Variante prüfen. Eine globale Medienänderung nicht als Beweis verwenden, dass alle bestehenden Blöcke aktualisiert wurden.

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: WordPress mit klassischem oder Block-Theme. SEO-Plugins und Page-Builder unterscheiden sich; es gibt keinen universellen Menüpfad für alle Installationen.

Den allgemeinen Fehler einordnen

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

Dokumentation zur Konfiguration und zum Prüfsignal

WordPress: Bildausgabe mit Größen und Attributen

W3C: Aufgabe und Alternative eines Bildes

web.dev: Bildausgabe optimieren

Verwandte Medien-Fehler in WordPress