Skip to content
Nahaufnahme eines Computerbildschirms mit einem macOS-Dock mit bunten Programmsymbolen unter einem Raster aus Foto-Vorschaubildern.

Bilder ohne Alt-Text in WordPress finden – auch im Altbestand

Die Mediathek zeigt nicht an, welche Bilder keinen Alt-Text haben. Ihr scrollt durch Tausende Vorschaubilder und seht nicht, wo eine Beschreibung fehlt. Mit WP-CLI und einer Datenbankabfrage habt ihr die Zahl in Sekunden.

Schritt 1: Zählen

Die Abfrage liest nur und verändert nichts. Das Tabellenpräfix holt sich der Befehl selbst.

Ihr führt den Befehl per SSH im WordPress-Verzeichnis aus, also dort, wo die Datei wp-config.php liegt. Ohne SSH-Zugang nutzt ihr dieselbe Abfrage in phpMyAdmin (Reiter „SQL“). Dort ersetzt ihr $(wp db prefix) durch euer Tabellenpräfix, meist wp_, und lasst wp db query " samt den Anführungszeichen weg.

wp db query "SELECT COUNT(*) AS ohne_alt FROM $(wp db prefix)posts p LEFT JOIN $(wp db prefix)postmeta m ON m.post_id = p.ID AND m.meta_key = '_wp_attachment_image_alt' WHERE p.post_type = 'attachment' AND p.post_mime_type LIKE 'image/%' AND (m.meta_value IS NULL OR m.meta_value = '');"

Wollt ihr die Bilder selbst sehen, ersetzt COUNT(*) AS ohne_alt durch p.ID, p.post_title.

Schritt 2: Lesen, was die Zahl bedeutet

Eine Zahl ohne Einordnung führt in die Irre.

  • Dekorative Bilder sollen ein leeres Alt-Attribut haben. Die Abfrage zählt sie mit, obwohl sie nicht falsch sind.
  • Die Abfrage prüft das Feld in der Mediathek. In Gutenberg lässt sich der Alt-Text pro Block überschreiben. Ein Bild kann im Beitrag korrekt beschriftet sein, obwohl die Mediathek leer ist, und umgekehrt.
  • Die Zahl ist ein Startpunkt für eine Prioritätenliste: Bilder auf Startseite, in Produktseiten und in den meistbesuchten Beiträgen zuerst.

Welche Felder die Mediathek noch kennt, steht in diesem Artikel.

Schritt 3: Den Bestand abarbeiten

Von Hand ist das bei Hunderten Bildern keine Option. Die Pro-Version von IMG Performer erzeugt Alt-Texte für bestehende Bilder über eine Bulk-Warteschlange im Hintergrund. Auf der Kommandozeile geht es mit wp imp alt-text. Vorher prüft ihr mit --dry-run, was passieren würde, und begrenzt einen ersten Lauf mit --limit, zum Beispiel auf zwanzig Bilder. Die Texte schaut ihr stichprobenartig an, bevor ihr den ganzen Bestand freigebt.

Für die KI-Texte geht das Bild an den Anbieter, dessen API-Key ihr im Plugin hinterlegt. Dafür braucht ihr einen Auftragsverarbeitungsvertrag mit dem Anbieter. Wir empfehlen Mistral, ein EU-Unternehmen mit Servern in der EU.

Danach

Der Bestand ist einmal erledigt, die nächsten Bilder bringt die Redaktion. Damit sich das Problem nicht wiederholt, braucht es eine Regel für neue Uploads. Sie gehört in die Redakteursdoku.

Mit der Pro-Version von IMG Performer müsst ihr nicht an jedes neue Bild denken. Das Plugin erzeugt den Alt-Text direkt beim Upload, ohne dass jemand einen Button drückt. Voraussetzung sind der hinterlegte API-Key des KI-Anbieters und die Standardeinstellung für Uploads („Automatisch“, nicht „Manuell“). Die Texte schaut ihr weiterhin stichprobenartig an, vor allem bei Bildern mit viel Kontext.

Beitragsbild: Jamie Street / Unsplash