Json Ld

Was ist JSON-LD?

JSON-LD ist ein Format, mit dem Websites strukturierte Daten maschinenlesbar bereitstellen. Die Abkürzung steht für JavaScript Object Notation for Linked Data. Der Code beschreibt Entitäten wie Unternehmen, Produkte, Artikel oder Veranstaltungen und ihre Beziehungen, damit Suchmaschinen den Seiteninhalt eindeutiger einordnen können.

Wie funktioniert JSON-LD?

JSON-LD überträgt verknüpfte Daten im JSON-Format, ohne einzelne sichtbare HTML-Elemente auszeichnen zu müssen. Der Code steht in einem oder mehreren <script type='application/ld+json'>-Blöcken und kann unabhängig vom sichtbaren Layout gepflegt werden. Suchmaschinen lesen daraus, welche Entität eine Seite beschreibt und welche Eigenschaften zu dieser Entität gehören.

Das Vokabular stammt meistens von Schema.org. @context legt das verwendete Vokabular fest, @type benennt die Art der Entität und weitere Eigenschaften beschreiben deren Merkmale. Ein Unternehmen kann beispielsweise durch Name, URL und Logo gekennzeichnet werden. Ein Produkt benötigt andere Angaben, etwa Marke, Angebot und Verfügbarkeit. Strukturierte Daten werden besonders für Ratgeber, FAQs und Produktseiten eingesetzt.

Ein einfaches Beispiel lautet: <script type='application/ld+json'> { '@context': 'https://schema.org', '@type': 'Organization', '@id': 'https://www.beispiel.de/#organization', 'name': 'Beispiel GmbH', 'url': 'https://www.beispiel.de/', 'logo': 'https://www.beispiel.de/logo.png' } </script>. Die ID ermöglicht es, dieselbe Organisation in weiteren Datensätzen eindeutig zu referenzieren.

JSON-LD und strukturierte Daten

JSON-LD und strukturierte Daten sind keine Synonyme. Strukturierte Daten sind die inhaltlichen Angaben über eine Entität. JSON-LD ist lediglich eines der Formate, mit denen diese Angaben in eine Website eingebunden werden. Schema.org liefert wiederum das gemeinsame Vokabular, aus dem Typen wie Organization, Product, Article oder LocalBusiness stammen.

Die drei Ebenen lassen sich klar trennen:

  • Schema.org definiert Entitätstypen und zulässige Eigenschaften.
  • Strukturierte Daten beschreiben die konkrete Organisation, Leistung oder Information.
  • JSON-LD übermittelt diese Beschreibung in einem maschinenlesbaren Codeformat.

Ein technisch gültiger Datensatz ist nicht automatisch inhaltlich korrekt. Ein Produkt-Markup kann fehlerfrei geschrieben sein und trotzdem falsche Preise enthalten. Prüfe deshalb zuerst die Übereinstimmung mit dem sichtbaren Seiteninhalt und erst danach die Syntax.

JSON-LD für SEO und GEO

JSON-LD kann Suchmaschinen helfen, Namen, Eigenschaften und Beziehungen einer Seite präziser zu verstehen. Passende strukturierte Daten können eine Voraussetzung für erweiterte Suchergebnisse sein, etwa für Produktinformationen, Veranstaltungen, Stellenangebote oder Breadcrumbs. Eine fehlerfreie Auszeichnung garantiert jedoch weder ein Rich Result noch ein besseres Ranking.

Für GEO, also Generative Engine Optimization, liefert JSON-LD zusätzliche semantische Signale. Eindeutige Entitäten, konsistente Namen und stabile Verknüpfungen über @id erleichtern maschinellen Systemen die Zuordnung von Unternehmen, Autoren, Angeboten und Inhalten. Ob ChatGPT, Perplexity, Gemini oder andere Systeme eine Seite zitieren, hängt zusätzlich von Inhalt, technischer Zugänglichkeit, Autorität und den jeweils verwendeten Quellen ab.

JSON-LD ergänzt deshalb eine saubere Onpage-Optimierung, ersetzt sie aber nicht. Sichtbarer Inhalt, interne Verlinkung, Indexierbarkeit und konsistente Unternehmensangaben bleiben die Grundlage. Eine umfassende Anleitung bietet der Ratgeber zur Optimierung einer Website für Google.

JSON-LD oder Microdata?

Der Unterschied zwischen JSON-LD und Microdata liegt in der Einbindung. Microdata ergänzt sichtbare HTML-Elemente direkt um Attribute wie itemtype und itemprop. RDFa arbeitet ähnlich mit Attributen im Markup. JSON-LD trennt die Datenbeschreibung vom sichtbaren HTML und lässt sich dadurch häufig leichter erstellen, aktualisieren und automatisiert ausspielen.

Kriterium JSON-LD Microdata und RDFa
Einbindung Separater Script-Block Attribute in sichtbaren HTML-Elementen
Pflege Zentral und vom Layout getrennt Eng mit dem Template verbunden
Fehlerrisiko Abweichung vom sichtbaren Inhalt Fehler durch Änderungen am HTML
Mehrere Entitäten Über @id und @graph verknüpfbar Über verschachtelte HTML-Strukturen verknüpfbar

Mehrere Formate auf derselben Seite sind technisch möglich. Doppelte Auszeichnungen erhöhen jedoch das Risiko widersprüchlicher Angaben. Wenn ein Shopsystem bereits Produktdaten als Microdata ausgibt und ein Plugin dieselben Produkte zusätzlich per JSON-LD beschreibt, müssen Preis, Verfügbarkeit, Bewertung und URL übereinstimmen.

Typische Fehler im JSON-LD

Viele Fehler entstehen nicht durch komplizierten Code, sondern durch getrennte Datenquellen. Das Template zeigt einen aktualisierten Preis, während der JSON-LD-Block noch einen älteren Wert aus einem Zwischenspeicher liefert. Suchmaschinen erhalten dadurch zwei unterschiedliche Aussagen über dasselbe Produkt.

  • Pflichtfelder für den gewählten Schema-Typ fehlen.
  • Eigenschaften werden einem unpassenden @type zugeordnet.
  • Kommas, Klammern oder Anführungszeichen erzeugen ungültiges JSON.
  • Bewertungen, Preise oder Öffnungszeiten weichen vom sichtbaren Inhalt ab.
  • Mehrere Plugins erzeugen doppelte oder widersprüchliche Datensätze.
  • Entitäten erhalten wechselnde IDs und lassen sich nicht zuverlässig verbinden.
JSON-LD darf keine Inhalte vortäuschen, die Nutzer auf der Seite nicht finden. Markiere beispielsweise keine Bewertungen, Veranstaltungen oder Preise, wenn die entsprechenden Angaben im sichtbaren Inhalt fehlen. Valider Code schützt nicht vor einer inhaltlich unzulässigen Auszeichnung.

JSON-LD prüfen und pflegen

JSON-LD sollte nach jeder relevanten Änderung am Template, Shopsystem oder Datenfeed erneut validiert werden. Die Prüfung umfasst zwei Ebenen: Zuerst muss der Code syntaktisch gültiges JSON enthalten. Danach ist zu kontrollieren, ob der gewählte Schema-Typ die erforderlichen Eigenschaften besitzt und alle Werte mit der veröffentlichten Seite übereinstimmen.

Messbar ist die technische Qualität zum Beispiel über die Fehlerquote: Anzahl der URLs mit ungültigem oder widersprüchlichem Markup geteilt durch die Zahl der geprüften URLs, multipliziert mit 100. Enthalten 4 von 200 geprüften Seiten fehlerhaftes JSON-LD, beträgt die Fehlerquote 2 Prozent. Zusätzlich solltest du Warnungen nach Seitentyp trennen, weil ein Fehler in einem zentralen Produkt-Template zahlreiche URLs gleichzeitig betreffen kann.

Ein technischer SEO-Audit sollte außerdem kontrollieren, ob strukturierte Daten nur auf indexierbaren URLs stehen, ob kanonische URLs korrekt referenziert werden und ob dynamische Werte zuverlässig aktualisiert werden. Bei Produktseiten gehören Preis, Währung und Verfügbarkeit zu den Feldern, die nach Shop- oder Feed-Änderungen besonders sorgfältig geprüft werden.

Häufige Fragen zu JSON-LD

Wo wird JSON-LD in einer Website eingefügt?

JSON-LD wird in einem Script-Element mit dem Typ 'application/ld+json' eingebunden. Der Block kann im Head oder Body der HTML-Seite stehen, sofern er beim Abruf der Seite für Suchmaschinen zugänglich ist.

Kann eine Seite mehrere JSON-LD-Blöcke enthalten?

Ja, eine Seite darf mehrere JSON-LD-Blöcke enthalten. Zusammengehörige Entitäten sollten über stabile IDs verbunden werden, und doppelte Datensätze dürfen keine widersprüchlichen Angaben liefern.

Verbessert JSON-LD automatisch das Google-Ranking?

Nein, JSON-LD erzeugt keinen automatischen Ranking-Vorteil. Strukturierte Daten helfen Suchmaschinen beim Verständnis der Seite und können die Eignung für bestimmte erweiterte Suchergebnisse herstellen.

Was ist der Unterschied zwischen JSON und JSON-LD?

JSON ist ein allgemeines Format für strukturierte Daten. JSON-LD ergänzt Regeln für verknüpfte Daten, etwa durch '@context', '@type' und '@id', damit Entitäten und ihre Beziehungen eindeutig beschrieben werden können.

Muss der Inhalt aus JSON-LD auf der Seite sichtbar sein?

Die ausgezeichneten Angaben müssen dem sichtbaren Seiteninhalt entsprechen. Der Code selbst bleibt unsichtbar, doch markierte Preise, Bewertungen, Termine oder Unternehmensdaten dürfen den Nutzern keine abweichenden Informationen vermitteln.

Welcher Schema-Typ ist für eine Seite richtig?

Der Schema-Typ richtet sich nach dem Hauptinhalt der jeweiligen URL. Eine Produktseite verwendet beispielsweise 'Product', ein redaktioneller Beitrag 'Article' und eine Unternehmensseite je nach Inhalt 'Organization' oder einen spezifischeren Organisationstyp.

Wenn du strukturierte Daten, Indexierbarkeit und technische Seitensignale gemeinsam prüfen lassen möchtest, bietet ein Potenzialcheck eine belastbare Grundlage für die nächsten Maßnahmen.

Kostenloser Potenzialcheck


Sie haben noch Fragen?

Kontaktieren Sie uns

SEO Agentur kostenlose SEO Potentialanalyse


Weitere Inhalte