Validierung & Qualitätssicherung
Nach jeder Template- oder Plugin-Änderung solltest du die Ausgabe prüfen. Das Plugin bringt dafür einen eigenen Validierungs-Tab mit und verlinkt direkt zu den beiden maßgeblichen externen Prüfwerkzeugen.
Der Validierungs-Tab im Backend
Unter Plugins → Structured Data → Validierung gibst du eine Storefront-URL ein. Das Plugin ruft die Seite ab, zählt alle gefundenen application/ld+json-Blöcke und prüft jeden auf gültiges JSON.
- Öffne den Tab Validierung.
- Gib die zu prüfende Storefront-URL ein und klicke auf Prüfen.
- Kontrolliere die Trefferzahl: Es sollte genau ein Block gefunden werden.
- Öffne bei Bedarf per Direktlink den Google Rich Results Test oder den Schema.org Validator für dieselbe URL.
Mehr als ein Block ist ein Warnsignal
Das Plugin liefert pro Seite genau einen konsolidierten @graph. Findet der Validierungs-Tab mehrere JSON-LD-Blöcke, deutet das auf konkurrierende Template- oder Plugin-Snippets hin. Prüfe, ob ein anderes Plugin oder ein Template-Anpassung zusätzliche strukturierte Daten ausgibt, und entferne diese.
Der empfohlene Validierungs-Workflow
- Google Rich Results Test — teste je eine URL pro Seitentyp: Startseite, Vater-PDP, Kind-PDP, Kategorie. (
https://search.google.com/test/rich-results) - Schema.org Validator — füge das gerenderte JSON-LD ein. Ziel: 0 Fehler / 0 Warnungen. (
https://validator.schema.org/) - Google Search Console → Verbesserungen — beobachte die Berichte wöchentlich.
Typische Search-Console-Fehler
Der häufigste Fehler in JTL-Shops — „Entweder price oder priceSpecification.price müssen angegeben werden” — stammt aus der unvollständigen NOVA-Microdata, nicht aus diesem Plugin. Die Option „JTL-Microdata entfernen” (Tab Allgemein, standardmäßig aktiv) beseitigt genau diese Quelle, indem sie die konkurrierenden itemscope/itemtype-Hüllen entfernt.
Nach Änderungen den Cache bedenken
Ist der Cache aktiv, kann die Ausgabe für einen Moment noch die alte Form zeigen. Das Plugin invalidiert ausschließlich seinen eigenen Cache (msd_graph) — fremde Plugin- und Artikel-Caches bleiben unberührt. Bei strukturellen Änderungen am Graph greift die interne Strukturversion und erneuert die gecachte Ausgabe automatisch.
Geduld bei Google
Strukturierte Daten sind die technische Voraussetzung für Rich Results und KI-Übersichten. Ob und wie eine Suchmaschine sie anzeigt, entscheidet sie selbst — und das kann nach einer Änderung einige Zeit dauern. Valide Ausgabe heute heißt nicht garantiert Rich Result morgen, ist aber die notwendige Grundlage.