Fehlende Alt-Texte in WooCommerce finden und beheben

Ein WooCommerce-Shop kann Hunderte oder Tausende Bilder enthalten.

Produktbilder, Galeriebilder, Varianten, Kategoriebilder, Bilder in Produktbeschreibungen und ältere Medien aus früheren Importen sammeln sich schnell an.

Irgendwann stellt sich eine einfache Frage:

Welche dieser Bilder haben eigentlich keinen sinnvollen Alt-Text?

Bei zehn Bildern lässt sich das noch manuell prüfen.

Bei 2.000 Bildern wird daraus eine andere Aufgabe.

Und dabei reicht es nicht immer, nur in die WordPress-Mediathek zu schauen. Entscheidend ist, welcher Alt-Text auf der tatsächlichen Shop-Seite im HTML ausgegeben wird.

Dieser Leitfaden zeigt, wie du fehlende Alt-Texte in WooCommerce findest, wie du zwischen echten Problemen und korrekten leeren Alt-Attributen unterscheidest und wie du größere Shops systematisch prüfen kannst.

Was bedeutet „fehlender Alt-Text"?

Im HTML kann ein Bild unterschiedliche Zustände haben.

Ein Bild kann überhaupt kein alt-Attribut besitzen:

<img src="/produkt.jpg">

Es kann ein leeres Alt-Attribut besitzen:

<img src="/produkt.jpg" alt="">

Oder es kann einen beschreibenden Alt-Text enthalten:

<img src="/produkt.jpg" alt="Schwarze Leder-Umhängetasche">

Diese drei Fälle bedeuten nicht automatisch dasselbe.

Ein fehlendes alt-Attribut ist bei normalen Inhaltsbildern häufig ein Problem.

Ein leeres alt="" kann dagegen korrekt sein, wenn ein Bild rein dekorativ ist und keine Information vermittelt.

Ein sinnvoller Audit muss deshalb mehr tun, als nur nach leeren Feldern zu suchen.

Warum die WordPress-Mediathek allein nicht reicht

WordPress speichert den Alternativtext eines Bildes in der Mediathek.

Das Feld ist leicht mit Titel oder Beschriftung zu verwechseln. Die Unterschiede zeigt der Artikel WooCommerce Alt-Text vs. Bildtitel.

Das ist wichtig.

Aber für die tatsächliche Website zählt am Ende das HTML, das der Browser erhält.

Ein Bild kann in der Mediathek einen Alt-Text haben und auf der Produktseite trotzdem mit einem anderen oder leeren Wert ausgegeben werden.

Das kann zum Beispiel passieren durch:

• Themes;
• WooCommerce-Templates;
• Page Builder;
• bereits eingefügte Bilder mit eigenem Alt-Wert;
• Plugins;
• individuelle Templates;
• alte Inhalte;
• Caching.

Deshalb sollte ein WooCommerce-Alt-Text-Audit nicht nur fragen:

Was steht in WordPress?

Sondern auch:

Was wird auf der echten Seite tatsächlich ausgegeben?

So prüfst du ein einzelnes WooCommerce-Bild

Wenn du nur ein bestimmtes Bild untersuchen möchtest, geht das direkt im Browser.

1. Produktseite öffnen

Öffne die tatsächliche WooCommerce-Produktseite.

2. Bild auswählen

Klicke mit der rechten Maustaste auf das betreffende Bild und wähle Untersuchen oder Inspect.

3. <img>-Element suchen

Im HTML findest du zum Beispiel:

<img src="/uploads/schwarzer-rucksack.jpg" alt="">

In diesem Fall besitzt das Bild ein leeres Alt-Attribut.

Oder:

<img src="/uploads/schwarzer-rucksack.jpg" alt="Schwarzer Lederrucksack">

Dann wird ein beschreibender Alt-Text ausgegeben.

Diese Prüfung zeigt dir den Zustand, den Nutzer, Screenreader und andere Systeme tatsächlich erhalten.

Ein leeres Alt-Attribut ist nicht immer falsch

Einer der häufigsten Fehler bei automatisierten Alt-Text-Prüfungen ist die Annahme:

leer = kaputt

Das stimmt nicht immer.

Ein rein dekoratives Bild sollte normalerweise mit einem leeren Alt-Attribut ausgegeben werden:

alt=""

Dadurch können Screenreader dieses Bild überspringen.

Beispiele können sein:

• dekorative Linien;
• Hintergrundelemente;
• rein visuelle Ornamente;
• Bilder, die keine zusätzliche Information liefern.

Bei Produktbildern ist die Situation meist anders.

Wenn ein Bild das Produkt, eine Variante, ein Detail oder die Nutzung zeigt, vermittelt es normalerweise relevante Information.

Dann ist ein sinnvoller beschreibender Alt-Text meistens angebracht.

Die entscheidende Frage lautet:

Würde ein Nutzer relevante Information verlieren, wenn er dieses Bild nicht sehen könnte?

Genau diese Unterscheidung zwischen bedeutungsvollen und dekorativen Bildern ist auch für die Barrierefreiheit zentral. Mehr dazu steht im Ratgeber zu WooCommerce Alt-Texte, Barrierefreiheit und BFSG.

Welche WooCommerce-Bilder solltest du prüfen?

Ein WooCommerce-Shop besteht nicht nur aus dem Hauptbild jedes Produkts.

Ein vollständiger Audit sollte verschiedene Bildtypen berücksichtigen.

Hauptbilder

Das Hauptbild zeigt normalerweise das Produkt als Ganzes.

Beispiel:

Schwarze Lederhandtasche

Galeriebilder

Weitere Bilder können andere Ansichten oder Details zeigen.

Zum Beispiel:

Seitenansicht der schwarzen Lederhandtasche

Innenfächer der schwarzen Lederhandtasche

Variantenbilder

Eine Farb- oder Stilvariante kann ein eigenes Produktbild besitzen.

Zum Beispiel:

Dunkelgrüner Leinen-Sessel

Bilder in Produktbeschreibungen

Viele Shops verwenden zusätzliche Bilder direkt im Beschreibungstext.

Diese können ebenfalls fehlende Alt-Texte enthalten.

Kategorie- und andere Shop-Bilder

Auch Bilder außerhalb einzelner Produktseiten können relevante Inhalte vermitteln.

Wenn du nur die Hauptbilder kontrollierst, prüfst du deshalb möglicherweise nur einen Teil des tatsächlichen Bildbestands.

Fehlende Alt-Texte manuell finden

Für kleine Shops ist eine manuelle Prüfung durchaus möglich.

Du kannst:

1. Produkte öffnen;
2. die Hauptbilder prüfen;
3. die Galerie prüfen;
4. Varianten auswählen;
5. zusätzliche Produktbilder kontrollieren;
6. das ausgegebene HTML untersuchen.

Bei zehn oder zwanzig Produkten ist das vielleicht ausreichend.

Das Problem ist die Skalierung.

Angenommen, dein Shop enthält:

• 400 Produkte;
• durchschnittlich 5 relevante Bilder pro Produkt.

Das sind bereits rund 2.000 Bilder.

Eine manuelle Einzelprüfung wird dann schnell zum eigentlichen Projekt.

Und leider hat bislang noch kein Browser aus Mitleid angefangen, die Arbeit selbst zu erledigen.

Warum ein automatischer Scan sinnvoller ist

Bei einem großen Shop ist ein Site-Scan effizienter.

Dabei wird nicht nur die WordPress-Mediathek betrachtet, sondern die Bilder, die auf den tatsächlichen Seiten des Shops vorkommen.

Ein Scan kann Bilder zum Beispiel in Gruppen einteilen:

• Alt-Text fehlt;
• Alt-Text ist leer;
• Alt-Text ist vorhanden;
• Alt-Text wirkt generisch oder problematisch.

Dadurch entsteht zuerst ein Überblick.

Danach kannst du entscheiden, welche Bilder tatsächlich bearbeitet werden müssen.

Das ist wesentlich sinnvoller, als sofort alle vorhandenen Alt-Texte neu zu schreiben.

Fehlender Alt-Text ist nicht dasselbe wie schlechter Alt-Text

Ein Bild kann einen Alt-Text besitzen und trotzdem problematisch sein.

Beispiele:

Bild

Produkt

Foto

IMG_4821

product-final

Technisch ist das Feld nicht leer.

Inhaltlich ist die Beschreibung kaum hilfreich.

Darum sollte eine gute Prüfung zwei unterschiedliche Fragen stellen:

1. Fehlt ein Alt-Text?
2. Ist der vorhandene Alt-Text sinnvoll?

Die erste Frage lässt sich relativ einfach technisch beantworten.

Die zweite braucht mehr Kontext.

Für allgemeine Regeln zu guten Produktbild-Beschreibungen siehe Alt-Texte für WooCommerce-Produktbilder.

Wenn du auch generische, doppelte und automatisch übernommene Werte prüfen möchtest, hilft die WooCommerce Alt-Text-Checkliste.

Dateinamen sind ebenfalls ein Warnsignal

Große Produktkataloge enthalten häufig Alt-Texte wie:

IMG_8321

DSC_9928

shoe-black-side

product_332_main

Solche Werte stammen oft aus Bilddateien oder internen Importprozessen.

Sie sind nicht leer.

Aber sie sind meistens keine guten Alternativtexte.

Aus:

black-leather-shoe-side.jpg

könnte zum Beispiel werden:

Seitenansicht des schwarzen Lederschuhs

Ein sinnvoller Audit sollte deshalb nicht bei alt="" aufhören.

Was ist mit doppelten Alt-Texten?

Doppelte Alt-Texte sind nicht automatisch falsch.

Wenn dasselbe Bild mehrfach verwendet wird, kann dieselbe Beschreibung durchaus passen.

Problematisch wird es, wenn verschiedene Bilder unterschiedliche Informationen zeigen, aber alle denselben Text besitzen.

Beispiel:

Hauptbild:

Schwarzer Lederrucksack

Seitenansicht:

Schwarzer Lederrucksack

Innenansicht:

Schwarzer Lederrucksack

Detailaufnahme:

Schwarzer Lederrucksack

Alle Werte sind formal vorhanden.

Aber die zusätzlichen Bildinformationen gehen verloren.

Besser wären zum Beispiel:

Schwarzer Lederrucksack

Seitenansicht des schwarzen Lederrucksacks

Innenfächer des schwarzen Lederrucksacks

Nahaufnahme von Lederstruktur und Nähten

Darum ist ein vollständiger Audit mehr als eine Suche nach leeren Feldern.

Wo entstehen fehlende Alt-Texte in WooCommerce?

Es gibt nicht nur eine Ursache.

Typische Gründe sind:

Neue Produktbilder wurden ohne Alt-Text hochgeladen

Das ist der einfachste Fall.

Produktdaten wurden importiert

Bei großen CSV- oder anderen Importen können Bilder angelegt werden, ohne dass sinnvolle Alternativtexte vorhanden sind.

Alte Produkte wurden nie überarbeitet

Viele Shops wachsen über Jahre.

Bilder aus älteren Produktgenerationen können völlig andere Qualitätsstandards haben.

Themes oder Page Builder geben andere Werte aus

Der Wert in WordPress entspricht nicht immer dem Wert im finalen HTML.

Galeriebilder wurden übersehen

Das Hauptbild wurde gepflegt, zusätzliche Bilder nicht.

Varianten wurden später ergänzt

Neue Farb- oder Produktvarianten können eigene Bilder erhalten, deren Alt-Texte nicht geprüft wurden.

Das Ergebnis ist häufig ein gemischter Shop statt eines einheitlichen Problems.

Warum du nicht einfach jeden leeren Alt-Text automatisch füllen solltest

Angenommen, ein Scan findet 500 Bilder mit leerem alt="".

Es wäre verlockend, sofort für alle 500 Bilder Text zu generieren.

Aber einige davon könnten korrekt dekorativ sein.

Andere könnten Icons oder rein visuelle Interface-Elemente darstellen.

Deshalb braucht ein sinnvoller Workflow zuerst eine Bewertung.

Die Frage lautet nicht:

Wie bekomme ich überall Text hinein?

Sondern:

Welche Bilder brauchen tatsächlich eine Beschreibung?

Das reduziert unnötige Änderungen und verhindert, dass dekorative Bilder mit sinnlosen Texten versehen werden.

Gute bestehende Alt-Texte sollten bleiben

Ein Audit sollte ebenfalls erkennen, was nicht geändert werden muss.

Wenn ein Bild bereits diesen Alt-Text besitzt:

Weiße Keramik-Tischlampe mit Leinenschirm

und genau das zeigt, gibt es keinen guten Grund, ihn nur wegen einer neuen Automatisierung zu ersetzen.

Das Ziel ist nicht, möglichst viele Alt-Texte neu zu generieren.

Das Ziel ist, konkrete Probleme zu beheben.

Zum Beispiel:

• fehlender Text;
• generischer Text;
• Dateinamen;
• offensichtlich falsche Beschreibungen;
• sinnlose Duplikate.

Wie ein sinnvoller WooCommerce-Alt-Text-Audit aussieht

Für größere Shops bietet sich dieser Ablauf an:

1. Live-Shop scannen

Beginne mit den Bildern, die Nutzer tatsächlich auf deinen Seiten sehen.

2. Probleme klassifizieren

Unterscheide mindestens:

• fehlende Alt-Texte;
• leere Alt-Texte;
• sinnvolle vorhandene Alt-Texte;
• generische oder problematische Alt-Texte.

3. Kontext prüfen

Nicht jedes leere Alt-Attribut ist falsch.

Nicht jeder vorhandene Text ist gut.

4. Nur klare Probleme bearbeiten

Behalte gute Beschreibungen.

Korrigiere die Bilder, die wirklich Aufmerksamkeit brauchen.

5. Shop erneut scannen

Kontrolliere danach, ob die Änderungen tatsächlich auf der Website ausgegeben werden.

Genau darauf basiert der IMSCRIB-Workflow:

scannen → Probleme erkennen → korrigieren → erneut scannen

Was solltest du zuerst beheben?

Wenn ein großer Shop viele Probleme enthält, musst du nicht alles gleichzeitig bearbeiten.

Eine sinnvolle Reihenfolge ist:

1. Bedeutungsvolle Bilder ohne Alt-Text

Produktbilder und wichtige Inhaltsbilder mit komplett fehlender Beschreibung sind ein klarer Ausgangspunkt.

2. Generische Platzhalter

Zum Beispiel:

Bild

Produkt

Foto

3. Dateinamen

Zum Beispiel:

IMG_4482

oder:

product-final-3

4. Offensichtlich falsche Beschreibungen

Zum Beispiel ein rotes Produkt mit dem Alt-Text:

Schwarze Handtasche

5. Galerien mit identischen Beschreibungen

Wenn unterschiedliche Bilder relevante unterschiedliche Informationen zeigen, sollten diese Unterschiede beschrieben werden.

So arbeitest du von klaren Problemen zu feineren Qualitätsproblemen.

Kann KI beim Finden fehlender Alt-Texte helfen?

Das Erkennen eines komplett fehlenden alt-Attributs braucht keine KI.

Das ist eine technische Prüfung.

Interessanter wird KI bei der Frage:

Ist ein vorhandener Alt-Text überhaupt sinnvoll?

Zum Beispiel kann ein System unterscheiden zwischen:

IMG_4821

und:

Schwarzer Lederrucksack mit Fronttasche

Oder prüfen, ob ein vorhandener Text zum tatsächlichen Bild passt.

KI ist deshalb nicht nur für die Generierung neuer Texte interessant.

Sie kann auch helfen, bestehende Bildbeschreibungen zu bewerten.

Aber auch hier gilt:

Nicht jede vorhandene Beschreibung muss ersetzt werden.

Wie viele Bilder sollte ein Shop prüfen?

Im Grunde alle relevanten Bilder, die auf öffentlich zugänglichen Shop-Seiten tatsächlich verwendet werden.

Das bedeutet jedoch nicht, dass jedes Asset in der WordPress-Mediathek automatisch wichtig ist.

Eine Mediathek kann enthalten:

• alte, nicht mehr verwendete Bilder;
• Duplikate;
• Entwürfe;
• Dateien aus früheren Themes;
• Assets, die auf keiner öffentlichen Seite erscheinen.

Deshalb ist ein Scan der tatsächlichen Website oft sinnvoller als eine reine Bestandsaufnahme der Mediathek.

Er konzentriert sich auf die Bilder, die Nutzer wirklich erhalten.

Alt-Texte nach einer Katalogänderung erneut prüfen

Ein einmaliger Audit ist hilfreich.

Aber Produktkataloge ändern sich.

Neue Produkte werden angelegt.

Neue Bilder werden hochgeladen.

Varianten kommen hinzu.

Produkte werden importiert.

Galerien werden ausgetauscht.

Dadurch können später neue Alt-Text-Probleme entstehen.

Nach größeren Änderungen am Katalog ist es deshalb sinnvoll, den Shop erneut zu prüfen.

Besonders nach:

• großen Produktimporten;
• Migrationen;
• Theme-Wechseln;
• Änderungen an Produktgalerien;
• umfangreichen Bild-Updates.

So lässt sich feststellen, ob neue Bilder ohne sinnvolle Beschreibungen hinzugekommen sind.

FAQ

Wie finde ich Bilder ohne Alt-Text in WooCommerce?

Bei einzelnen Bildern kannst du das gerenderte <img>-Element im Browser prüfen. Für größere Shops ist ein Site-Scan effizienter, da damit viele öffentlich verwendete Bilder gleichzeitig untersucht werden können.

Ist ein leeres alt="" immer ein Fehler?

Nein. Rein dekorative Bilder sollten normalerweise ein leeres Alt-Attribut besitzen. Bei bedeutungsvollen Produkt- und Inhaltsbildern ist dagegen meistens ein beschreibender Alt-Text sinnvoll.

Reicht es, die WordPress-Mediathek zu prüfen?

Nicht immer. Entscheidend ist, welcher Alt-Text auf der tatsächlichen Seite im HTML ausgegeben wird. Themes, Page Builder und andere Komponenten können beeinflussen, welcher Wert am Ende erscheint.

Sind Dateinamen wie IMG_4821 gültige Alt-Texte?

Sie sind technisch Text, aber normalerweise keine sinnvollen Bildbeschreibungen. Ein guter Alternativtext beschreibt, was auf dem Bild relevant ist.

Muss ich alle vorhandenen Alt-Texte neu schreiben?

Nein. Gute bestehende Beschreibungen sollten beibehalten werden. Bearbeite vor allem fehlende, generische, falsche oder andere klar problematische Alt-Texte.

Wie oft sollte ich WooCommerce-Alt-Texte prüfen?

Nach größeren Änderungen am Produktkatalog, Importen oder Bild-Updates ist eine erneute Prüfung sinnvoll. Wie häufig das nötig ist, hängt davon ab, wie oft sich dein Shop verändert.

Fazit

Fehlende Alt-Texte in WooCommerce zu finden klingt zunächst nach einer einfachen Suche nach leeren Feldern.

Bei einem echten Shop ist die Situation komplizierter.

Ein leeres Alt-Attribut kann korrekt sein.

Ein ausgefülltes Alt-Attribut kann trotzdem nutzlos sein.

Und der Wert in der WordPress-Mediathek muss nicht immer exakt dem entsprechen, was auf der Shop-Seite ausgegeben wird.

Darum beginnt ein sinnvoller Audit beim tatsächlichen Shop.

Scanne die Bilder, unterscheide echte Probleme von korrekten Zuständen, behalte gute Beschreibungen und korrigiere nur das, was wirklich verbessert werden muss.

Bei kleinen Shops funktioniert das manuell.

Bei großen Produktkatalogen ist ein strukturierter Scan deutlich praktikabler.