Web-Entwicklung

JSON-LD

JSON-LD ist das von Suchmaschinen empfohlene Format, um strukturierte Daten als eigenständigen Datenblock im Quelltext einzubinden – getrennt vom sichtbaren HTML und dadurch wartungsärmer als eine Auszeichnung direkt in den Inhaltselementen.

JSON-LD ist eines von drei Formaten für strukturierte Daten und das von Suchmaschinen bevorzugte – die Alternativen Mikrodaten und RDFa zeichnen direkt im sichtbaren HTML aus.

In einfachen Worten

JSON-LD steht für eine verknüpfbare Variante des verbreiteten Datenformats JSON. Die Auszeichnung liegt dabei nicht verstreut in den sichtbaren Inhaltselementen, sondern gebündelt in einem separaten Datenblock im Seitenkopf, gekennzeichnet als Typ application/ld+json. Ein Block beschreibt zum Beispiel die Organisation, ein zweiter den Artikel mit Autor und Datum, ein dritter den Navigationspfad. Weil dieser Block vom Layout getrennt ist, lässt sich die Auszeichnung pflegen, ohne das umgebende HTML anzufassen – ein wesentlicher Vorteil gegenüber den Inline-Formaten Mikrodaten und RDFa. Suchmaschinen empfehlen JSON-LD ausdrücklich als bevorzugtes Format für strukturierte Daten, aus denen unter anderem Rich Snippets entstehen.

Wozu brauche ich das?

JSON-LD lässt sich zentral verwalten: In einem gut gebauten Verwaltungssystem wird die Auszeichnung je Seitentyp aus einer Vorlage erzeugt und aus den ohnehin vorhandenen Daten befüllt – Titel, Autor, Datum, Standort, Preis. So entsteht für Organisation, Artikel, Frage-Antwort-Bereiche und Breadcrumb-Markup eine konsistente Auszeichnung über die ganze Website, ohne dass jede Seite einzeln von Hand gepflegt werden muss. Bei einem Neuaufbau ist JSON-LD den Inline-Formaten in fast allen Fällen vorzuziehen.

Beispiel aus der Praxis

Eine typische Konstellation: Ein Blog erzeugt für jeden Artikel automatisch einen JSON-LD-Block aus Titel, Autor und Veröffentlichungsdatum, ergänzt um einen Frage-Antwort-Block, aus dem Rich Snippets entstehen können, und einen Pfad-Block für die Navigation. Alle drei entstehen aus einer einzigen Vorlage. Wird das Layout des Blogs später überarbeitet, bleibt die Auszeichnung unberührt, weil sie nicht im sichtbaren HTML steckt – gepflegt wird nur die Datenquelle, nicht das Markup an jedem einzelnen Element.

Wirtschaftlicher Nutzen

JSON-LD senkt den Pflegeaufwand und das Fehlerrisiko strukturierter Daten, weil Auszeichnung und Layout nicht verflochten sind – anders als bei den Inline-Formaten Mikrodaten und RDFa. Über Vorlagen je Seitentyp skaliert die Auszeichnung auf beliebig viele Seiten, ohne dass der Aufwand linear mitwächst. Der wirtschaftliche Vorteil liegt in der Wartbarkeit: Spätere Layout-Änderungen gefährden die Auszeichnung nicht, und die Daten lassen sich aus einer einzigen Quelle konsistent befüllen.

Typische Fehler

  • Ein Syntaxfehler im Datenblock – ein fehlendes Komma oder Anführungszeichen – sorgt dafür, dass der gesamte Block ignoriert wird.
  • Der Block beschreibt Angaben, die auf der Seite nicht sichtbar sind, und verstößt damit gegen die Richtlinien.
  • Mehrere Blöcke widersprechen sich, weil sie aus unterschiedlichen Quellen befüllt werden.
  • Verweise zwischen Entitäten sind inkonsistent gesetzt, sodass die Zuordnung nicht aufgeht.
  • Die Auszeichnung wird nie mit einem Test-Werkzeug geprüft und bleibt fehlerhaft im Einsatz.

Worauf achten?

  • Pro Seitentyp eine Vorlage anlegen und die Auszeichnung daraus erzeugen.
  • Nach jeder Änderung mit einem Test-Werkzeug auf Syntax und Pflichtfelder prüfen.
  • Den passenden Typ je Inhalt wählen, statt einen einzigen Block überall einzusetzen.
  • Die Daten aus einer einzigen, gepflegten Quelle befüllen, um Widersprüche zu vermeiden.
  • Die Angaben mit dem sichtbaren Inhalt der Seite konsistent halten.

Häufig gestellte Fragen

Was ist JSON-LD?

Ein Format, um strukturierte Daten als eigenständigen Datenblock im Seitenkopf einzubinden, getrennt vom sichtbaren HTML. Es ist das von Suchmaschinen empfohlene Format für die Auszeichnung nach Schema.org.

Warum wird JSON-LD gegenüber Mikrodaten und RDFa bevorzugt?

Weil die Auszeichnung vom Layout getrennt in einem eigenen Block liegt. Sie lässt sich zentral über Vorlagen pflegen, ohne das umgebende HTML zu verändern, und übersteht Layout-Änderungen unbeschadet.

Wo wird der JSON-LD-Block eingebunden?

Üblicherweise im Kopfbereich der Seite als Block vom Typ application/ld+json. Mehrere Blöcke pro Seite sind möglich – etwa je einer für die Organisation, den Artikel und den Navigationspfad.

Was passiert bei einem Fehler im Block?

Ein Syntaxfehler kann dazu führen, dass der gesamte Block ignoriert wird. Deshalb sollte die Auszeichnung nach jeder Änderung mit einem Test-Werkzeug auf Syntax und Pflichtfelder geprüft werden.