Strukturierte Daten prüfen: JSON-LD-Fehler, fehlende Eigenschaften und was Sie erwarten dürfen

Strukturierte Daten sind maschinenlesbare Informationen über eine Seite – etwa dass es sich um einen Artikel mit dieser Überschrift und diesem Autor handelt, um ein Produkt mit diesem Preis oder um ein Unternehmen unter dieser Adresse –, formuliert im Vokabular von schema.org. Suchmaschinen nutzen sie, um Inhalte zu verstehen und bei manchen Typen erweiterte Suchergebnisse anzuzeigen, etwa Produktpreise oder Breadcrumbs.

Google empfiehlt JSON-LD: einen <script type="application/ld+json">-Block mit einem JSON-Objekt, getrennt vom sichtbaren HTML. Dieses Format lässt sich am einfachsten einbauen und prüfen – und um dieses Format geht es in diesem Leitfaden.

So sieht gültiges JSON-LD aus

Ein minimaler Artikel: {"@context": "https://schema.org", "@type": "Article", "headline": "How to check structured data", "datePublished": "2026-09-26", "author": {"@type": "Organization", "name": "Example Team"}}. Jedes Objekt hat einen @type; verschachtelte Angaben (hier der Autor) sind Objekte mit eigenem Typ; Datumsangaben folgen ISO 8601; URLs sind absolut.

Fehler, die strukturierte Daten unbrauchbar machen

1. JSON, das sich nicht parsen lässt

Ein einziger Syntaxfehler, und Suchmaschinen ignorieren den gesamten Block. Die üblichen Ursachen: ein überzähliges Komma nach der letzten Eigenschaft, typografische Anführungszeichen, die aus einer Textverarbeitung hineinkopiert wurden, ein nicht maskiertes doppeltes Anführungszeichen oder ein Zeilenumbruch innerhalb eines Werts sowie Template-Variablen, die nichts ausgeben und "name": , hinterlassen. Stammt das JSON aus einem CMS-Feld, hat ein verirrtes HTML-Tag darin dieselbe Wirkung.

2. Fehlende zentrale Eigenschaften

Für jede Suchfunktion sind erforderliche Eigenschaften dokumentiert (ohne sie kommt die Seite für diese Funktion nicht infrage) und empfohlene (sie werten das Ergebnis auf). Eine Organization ohne name, ein Product ganz ohne offers, review oder aggregateRating oder ein Breadcrumb-Eintrag ohne position ist unvollständig. Googles Dokumentation zur Suchgalerie führt die Anforderungen je Funktion auf; sie ändern sich von Zeit zu Zeit – schlagen Sie also dort nach, statt sich auf Ihr Gedächtnis zu verlassen.

3. Ungültige URLs

url, logo und image sollten absolute, funktionierende URLs sein. Relative Pfade, Platzhalter wie # und Staging-Hostnamen kommen in Templates häufig vor.

4. Doppelte oder widersprüchliche Blöcke

Wenn sowohl ein Theme als auch ein SEO-Plugin einen Organization- oder WebSite-Block ausgeben, noch dazu mit unterschiedlichen Namen oder Logos, ist das bestenfalls verwirrend. Erzeugen Sie jeden Typ nur einmal.

5. Markup, das nicht zur Seite passt

Strukturierte Daten müssen beschreiben, was Besucher sehen können: Bewertungen, die nicht auf der Seite stehen, Preise, die vom angezeigten Preis abweichen, oder FAQ-Antworten, die nirgends erscheinen, verstoßen gegen Googles Richtlinien und können zu einer manuellen Maßnahme führen. Das kann Ihnen kein automatisiertes Prüftool abnehmen.

Worauf Rudras SEO-Checker achtet

Der kostenlose SEO-Checker liest jeden JSON-LD-Block im HTML, das Ihr Server ausliefert (auch Blöcke, die in HTML-Kommentare oder CDATA eingeschlossen sind, und Blöcke, deren Typangabe einen Zeichensatz enthält). Er meldet:

• Blöcke, die sich nicht parsen lassen, samt der Fehlermeldung des Parsers (eine Warnung mit Punktabzug, weil das Markup unbrauchbar ist);
• denselben @type, der mehr als einmal deklariert ist;
• Werte für url, logo oder image, die keine gültigen absoluten URLs sind;
• fehlende zentrale Eigenschaften für eine bewusst vorsichtige Auswahl gängiger Typen: name und url bei Organization und WebSite; headline, datePublished und author bei Article, BlogPosting und NewsArticle; name und address bei LocalBusiness; name sowie eines von offers, review oder aggregateRating bei Product; Fragen mit einem name und einem Antwort-text bei FAQPage; und Einträge mit einer position und einem name oder item bei BreadcrumbList.

Das sind sinnvolle Mindestanforderungen, kein Abbild der Vorgaben sämtlicher Suchmaschinen – für manche Funktionen verlangt Google mehr, und bei Article führt Google diese Eigenschaften als empfohlen und nicht als erforderlich. Der Checker liest nur das HTML, bevor JavaScript ausgeführt wird; strukturierte Daten, die ein Tag-Manager einfügt, sieht er also nicht. Betrachten Sie seine Befunde als ersten Durchgang und sichern Sie das Ergebnis mit den folgenden Tools ab.

Weitere nützliche Tools

• Googles Test für Rich-Suchergebnisse zeigt, für welche Google-Funktionen eine Seite infrage kommt und welche Fehler dem entgegenstehen. Er rendert JavaScript und sieht deshalb auch nachträglich eingefügtes Markup.
• Der Schema Markup Validator (validator.schema.org) prüft beliebiges schema.org-Markup gegen das Vokabular, unabhängig von Googles Funktionen.
• Die Berichte zu Verbesserungen in der Search Console zeigen Fehler und Warnungen für jeden Typ strukturierter Daten auf allen Seiten, die Google gecrawlt hat.

Was strukturierte Daten nicht versprechen können

Gültiges, vollständiges Markup macht eine Seite zu einem möglichen Kandidaten für erweiterte Suchergebnisse. Eine Garantie ist das nicht: Suchmaschinen entscheiden je Suchanfrage, ob sie diese anzeigen, und die Funktionen ändern sich. So hat Google 2023 die Rich-Suchergebnisse für FAQs auf eine kleine Gruppe maßgeblicher Behörden- und Gesundheitswebsites beschränkt und zeigt Rich-Suchergebnisse für HowTo gar nicht mehr an. Strukturierte Daten sind auch keine Abkürzung zu besseren Rankings; ihr Wert liegt darin, dass Suchmaschinen Ihre Inhalte richtig verstehen.

Ein einfacher Workflow

1. Erzeugen Sie JSON-LD aus Ihrem CMS oder Ihren Templates – aus denselben Daten, aus denen die Seite gerendert wird, damit beides nicht auseinanderlaufen kann.
2. Geben Sie jeden Typ nur einmal pro Seite aus.
3. Prüfen Sie nach jeder Template-Änderung eine Seite je Template mit dem SEO-Checker und dem Test für Rich-Suchergebnisse.
4. Behalten Sie nach Deployments die Berichte zu Verbesserungen in der Search Console im Blick, um neue Fehler zu erkennen.