Jetzt kommt der spannende Teil: Alt-Texte erzeugen. Das geht komfortabel über einen eigenen Bereich in der Administration – ganz ohne Programmierung. Du siehst auf einen Blick, welchen Bildern noch ein Alt-Text fehlt, wählst sie aus und lässt sie beschreiben.

Den Bereich öffnen

Öffne in der Administration Inhalte → Alt-Text Optimizer Pro.

Oben siehst du einen Status:

Bereit – alles ist konfiguriert, du kannst loslegen.
Nicht konfiguriert – es fehlt der OpenAI-Schlüssel oder das Modell. Hol das in der Konfiguration nach.

Die zwei Reiter verstehen

Der Bereich hat zwei Reiter (Tabs):

Ohne Alt-Text – hier landen alle Bilder, die noch keinen Alt-Text haben. Das ist deine To-do-Liste.
KI-generiert – hier siehst du alle Bilder, deren Alt-Text vom Plugin erstellt wurde. So behältst du den Überblick und kannst Texte bei Bedarf neu erzeugen oder entfernen.

Über das Suchfeld findest du Bilder schnell anhand ihres Dateinamens.

Alt-Texte erzeugen

Du hast drei Möglichkeiten:

Einzelnes Bild: Klicke in der Zeile des Bildes auf Alt-Text generieren.
Mehrere Bilder: Setze links die Häkchen bei den gewünschten Bildern und klicke dann auf Alt-Texte generieren.
Alle auf einmal: Mit Alle generieren verarbeitest du alle Bilder des aktuellen Reiters (siehe Hinweis zum Limit unten).

Mehrere Bilder sind per Häkchen ausgewählt; über das Drei-Punkte-Menü lässt sich für ein einzelnes Bild ein Alt-Text generieren. — Bilder per Häkchen auswählen und über „Alt-Texte generieren“ starten – oder einzeln über das …-Menü.

Anschließend öffnet sich eine Fortschrittsseite. Dort siehst du je Bild den Status – Ausstehend, Wird verarbeitet, Erfolgreich oder Fehler – sowie einen Fortschrittsbalken. Die Bilder werden nacheinander abgearbeitet; bei großen Mengen dauert das also einen Moment. Am Ende bekommst du eine Zusammenfassung, wie viele Texte erstellt wurden.

Fortschrittsseite während der Generierung: Fortschrittsbalken bei 33 Prozent und eine Tabelle mit dem Status je Bild. — Während der Generierung: Fortschrittsbalken und Status je Bild (erfolgreich, wird verarbeitet, ausstehend).

Abgeschlossene Generierung: Fortschritt bei 100 Prozent, Meldung über drei erfolgreich erstellte Alt-Texte. — Fertig: Am Ende siehst du auf einen Blick, wie viele Alt-Texte erstellt wurden.

Limit pro Durchgang: 100 Bilder. Wählst du mehr aus, verarbeitet das Plugin die ersten 100 und weist dich darauf hin. Arbeite große Mediatheken einfach in mehreren Durchgängen ab – so behältst du auch Ergebnisse und Kosten gut im Blick.

Texte prüfen, neu erzeugen oder entfernen

Im Reiter KI-generiert kannst du jederzeit:

einen Text neu generieren (z. B. nachdem du die Länge oder Sprache geändert hast),
einen Alt-Text wieder entfernen – das Bild taucht dann erneut unter Ohne Alt-Text auf.

Reiter „KI-generiert“ mit einer Liste von Bildern und ihren KI-erstellten Alt-Texten sowie Aktionen zum Neu-Generieren oder Entfernen. — Im Reiter „KI-generiert“ findest du alle erzeugten Alt-Texte – zum Prüfen, Neu-Generieren oder Entfernen.

So bleibst du jederzeit Herr über die Texte. Du kannst einen Alt-Text natürlich auch ganz normal direkt am Medium von Hand anpassen.

Was du wissen solltest

Bestehende Alt-Texte werden überschrieben. Erzeugst du für ein Bild einen neuen Text, ersetzt er einen eventuell vorhandenen. Im Reiter „Ohne Alt-Text“ passiert das nicht – dort stehen ja nur Bilder ohne Text.

Nur Bilder werden verarbeitet. Unterstützt sind JPG, PNG, GIF und WebP. Andere Dateien (PDFs, Videos, SVG) überspringt das Plugin mit einem Hinweis.
Die Bilddatei muss erreichbar sein. Sie muss physisch im public-Ordner deines Shops liegen. Bei ausgelagertem Speicher (externer CDN/Cloud-Storage) muss das Bild über seine URL abrufbar sein.
Sehr große Dateien (über 20 MB) werden übersprungen.
Tageslimits von OpenAI: Bei sehr vielen Bildern in kurzer Zeit kann OpenAI bremsen („Rate Limit“). Dann einfach kurz warten und erneut starten.

Wo landet der Alt-Text?

Der fertige Text wird im normalen Alt-Text-Feld des Bildes in Shopware gespeichert. Er ist damit sofort im Shop aktiv – genau so, als hättest du ihn von Hand eingetragen. Zusätzlich merkt sich das Plugin (über ein unsichtbares Feld), dass der Text von der KI stammt, damit er im Reiter KI-generiert auftaucht.

Für Entwickler: API-Endpunkte

Diesen Abschnitt brauchst du nur für eigene Integrationen oder Automatisierungen. Für die normale Nutzung im Adminbereich ist er nicht relevant.

Das Plugin stellt zwei Admin-API-Routen bereit, die auch die Oberfläche nutzt.

Alt-Text für ein einzelnes Medium generieren:

POST /api/_action/ai-alttext/generate-single
Content-Type: application/json

{
  "mediaId": "0188f...",
  "salesChannelId": null
}

Erfolgsantwort:

{
  "success": true,
  "mediaId": "0188f...",
  "altText": "Schwarze Laufschuhe mit weißer Sohle auf hellem Hintergrund"
}

Konfiguration prüfen:

GET /api/_action/ai-alttext/check-config?salesChannelId=...

{
  "valid": true,
  "model": "gpt-4o-mini"
}

Schlägt etwas fehl, antworten die Routen mit success: false bzw. valid: false und einer aussagekräftigen Meldung. Die häufigsten Ursachen findest du in der Fehlerbehebung.