Strukturierte Daten prüfen

Eine zweite Fassung der Seite, geschrieben für Maschinen

Zeigen Sie einem Menschen eine Produktseite, und er weiß sofort, welche Zahl der Preis ist und welche der Lagerbestand. Ein Programm sieht nur Text. Strukturierte Daten ersparen ihm das Raten. Neben der sichtbaren Seite veröffentlichen Sie dieselben Fakten als beschriftete Felder, mit Namen aus dem gemeinsamen Vokabular von schema.org. Dieses Ding ist ein Product, sein name lautet so, seine offers enthalten einen price von 49.00 in USD.

Es gibt drei Schreibweisen. JSON-LD packt alles in ein einziges Script-Tag, getrennt vom Layout, und ist die Form, die Google empfiehlt. Microdata und RDFa verteilen die Beschriftungen als Attribute über die HTML-Tags.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How tides work",
  "datePublished": "2026-03-14T09:30:00+00:00",
  "author": { "@type": "Person", "name": "Jane Doe" }
}
</script>

Suchmaschinen nutzen diese Felder für reichhaltigere Ergebnisse, mit Bewertungssternen, einem Preis, einem Rezeptfoto oder einem Veranstaltungsdatum. Man nennt sie Rich Results.

Was diese Prüfung liest

Unser Server lädt die Seite einmal herunter, bis zu 3 MB, und führt ihre Skripte nicht aus. Dann arbeitet er in vier Schritten.

1. Syntax. Jeder JSON-LD-Block läuft durch einen strengen JSON-Parser. Beim ersten Fehler nennt er Zeile, Zeichen und die wahrscheinliche Ursache: ein Komma vor einer schließenden Klammer, ein nicht maskiertes Anführungszeichen in einem Text, typografische Anführungszeichen aus einer Textverarbeitung, ein HTML-Kommentar, ein roher Zeilenumbruch. Ein einziger Fehler reicht, damit ein Parser den ganzen Block verwirft.
2. Elemente. @graph-Listen werden aufgeklappt, sodass jedes Element einzeln erscheint, mit seinem Typ und einer Gliederung seiner Eigenschaften. Eine Eigenschaft, die mit @id auf ein anderes Element verweist, wird verfolgt, wenn das Ziel auf der Seite steht.
3. Eigenschaften. Bei den Typen, die ein Rich Result speisen, wird das Element mit einer Liste von Pflicht- und empfohlenen Eigenschaften aus der Google-Dokumentation verglichen.
4. Werte. In jedem Element müssen Adressen absolut sein, Datums- und Zeitdauerangaben ISO 8601 folgen, @context muss schema.org sein, und jeder @id-Verweis muss irgendwohin führen.

Microdata (itemscope, itemtype) und RDFa (typeof) werden gezählt und nach Typ benannt. Ihre Eigenschaften werden nicht validiert.

Die Typen, die wir vergleichen, und was sie brauchen

Andere Typen werden gegliedert und ihre Werte geprüft, ohne Liste der Pflichteigenschaften.

Beheben, was der Bericht zeigt

Ein Syntaxfehler

Von Hand bearbeitete Blöcke scheitern an Kommas und Anführungszeichen. Erzeugen Sie den Block mit einem JSON-Encoder (json_encode in PHP, JSON.stringify in JavaScript), und diese ganze Fehlerfamilie verschwindet. In einem CMS fügen Sie JSON-LD in ein Code-Feld ein. Nehmen Sie dafür nie den visuellen Editor, denn er macht aus den Anführungszeichen typografische.

Eine Pflichteigenschaft fehlt

Ergänzen Sie sie, mit dem Wert, den ein Besucher auf der Seite sieht. Suchmaschinen vergleichen beides, und Markup, das etwas beschreibt, das die Seite nicht zeigt, kann Ihnen eine manuelle Maßnahme einbringen.

Eine relative Adresse

Schreiben Sie https://www.example.com/img/cover.jpg vollständig aus, nicht /img/cover.jpg.

Ein Datum, das nicht ISO 8601 entspricht

Zuerst das Jahr, dann T, dann die Uhrzeit und der Abstand zu UTC: 2026-03-14T09:30:00+00:00. Ein Tag allein, 2026-03-14, ist ebenfalls gültig.

Ein Verweis ins Leere

"author": {"@id": "…/#jane"} funktioniert nur, wenn ein Element mit genau dieser @id auf derselben Seite steht. Fügen Sie das Element hinzu, oder schreiben Sie den Autor direkt an Ort und Stelle.

Was diese Prüfung Ihnen nicht sagen kann

Sie liest das HTML so, wie es ausgeliefert wird. Strukturierte Daten, die nachträglich per JavaScript oder über einen Tag-Manager eingefügt werden, sind hier unsichtbar, obwohl Google sie nach dem Rendern sehen kann. Bilder werden nicht heruntergeladen, ein defektes oder zu kleines Bild fällt also nicht auf. Die Eigenschaftslisten decken die gängigen Ergebnistypen ab. Sie decken nicht jeden Typ und nicht jedes optionale Feld ab.