JSON-LD richtig aufzubauen, heißt vor allem, die Angaben miteinander zu verbinden. Strukturierte Daten sind auf den meisten Websites vorhanden, oft von mehreren Erweiterungen gleichzeitig ausgegeben. Syntaxfehler sind dabei selten das Problem. Häufiger stehen die Angaben nebeneinander, ohne aufeinander zu verweisen. Google empfiehlt JSON-LD als Format für strukturierte Daten [1], und das Format selbst bringt mit @graph und @id alles mit, was für Verknüpfungen nötig ist [2].
Was strukturierte Daten grundsätzlich sind, erklärt das Glossar unter Strukturierte Daten. Dieser Beitrag geht einen Schritt weiter und zeigt, wie ein zusammenhängender Graph aussieht.
Das Problem mit Einzelblöcken
Eine typische Beitragsseite gibt drei Blöcke aus: einen für den Artikel, einen für die Organisation, einen für die Brotkrumen-Navigation. Jeder ist für sich gültig. Zusammen beschreiben sie drei Dinge, die zufällig auf derselben Seite stehen. Dass der Artikel von einer bestimmten Person stammt und diese Person für diese Organisation arbeitet, steht nirgends.
Für ein System, das eine Aussage einer Quelle zuordnen soll, ist genau das der wichtige Teil. Ohne Verknüpfung bleibt der Autorname eine Zeichenkette. Bei häufigen Namen lässt sich dann nicht unterscheiden, welche Person gemeint ist.
Wie ein Graph aussieht
Die JSON-LD-Norm des W3C sieht das Schlüsselwort @graph vor, um einen Graphen auszudrücken, und @id, um Knoten eindeutig zu kennzeichnen. Ein Knoten, der nur aus einer @id besteht, verweist auf einen Knoten, der an anderer Stelle im Dokument beschrieben ist [2]. Ein Block mit @graph enthält damit alle Knoten einer Seite, und jeder verweist über die Kennung auf die anderen:
- die WebSite mit Name, Adresse und Herausgeber,
- die WebPage, die zur Website gehört und den Artikel enthält,
- den Article mit Datum, Schlagworten und einem Verweis auf den Autor,
- die Person mit Fachgebieten, Profiladressen und Arbeitgeber,
- die Organization mit Kontaktdaten und eigenen Profilen,
- die BreadcrumbList mit dem Pfad zur Seite.
Die Kennungen sind beständig. Dieselbe Person trägt auf allen Seiten dieselbe @id, im SEO CMS etwa die Adresse der Website mit dem Zusatz #person und dem Slug des Autors, die Organisation entsprechend #organization. Erst dadurch wird die Person über die Website hinweg wiedererkennbar. Wie das CMS diese Knoten erzeugt, steht unter Strukturierte Daten und Antwortkästen.
Noch eine Frage offen?
In der gratis Sprechstunde beantworten wir Fragen zu SEO live, jeden ersten Samstag im Monat um 18 Uhr. Oder du rufst einfach an.
Fünf Fehler, die regelmäßig vorkommen
Leere Werte
Ein Bildfeld ohne Bild, ein Telefonfeld ohne Nummer. Die Angabe behauptet etwas, das es nicht gibt. Felder ohne Wert lässt du besser ganz weg.
Auszeichnung ohne Entsprechung
Google verlangt, dass strukturierte Daten den Inhalt der Seite realitätsgetreu wiedergeben, und untersagt die Auszeichnung von Inhalten, die Leser nicht sehen können [1]. Eine Bewertung im JSON-LD, die auf der Seite nirgends erscheint, ist so ein Fall. Probleme mit strukturierten Daten können laut Google zu einer manuellen Maßnahme führen [1].
Wechselnde Kennungen
Wird die Kennung einer Person aus dem Anzeigenamen gebildet oder bei jedem Bau neu erzeugt, gibt es keine wiedererkennbare Einheit. Im SEO CMS war das bis zu einer früheren Fassung so: Die Autorenkennung entstand aus dem Anzeigenamen, und der Verweis in jedem Beitrag zeigte ins Leere. Heute leitet sie sich aus dem festen Slug ab.
sameAs auf eigene Unterseiten
Schema.org definiert sameAs als Adresse einer Referenzseite, die die Identität eines Gegenstands eindeutig belegt, etwa ein Wikipedia- oder Wikidata-Eintrag oder die offizielle Website [3]. Ein Verweis von der eigenen Seite auf eine andere eigene Unterseite belegt nichts. Sinnvoll sind Ziele, die jemand anderes betreibt. Mehr dazu im Lexikoneintrag sameAs.
Datum ohne Zeitzone
Ist in PHP weder per date_default_timezone_set noch in der Einstellung date.timezone eine Zeitzone gesetzt, rechnet PHP mit UTC [4]. Eine Zeit aus der Datenbank wird dann ohne Hinweis falsch ausgewiesen, nämlich um den Abstand zwischen UTC und der deutschen Uhrzeit verschoben. Betroffen sind genau die Angaben, für die man überhaupt ein Datum auszeichnet: Veröffentlichung und letzte Änderung. Das SEO CMS setzt die Zeitzone deshalb standardmäßig auf Europe/Berlin.
Wie du es prüfst
Öffne den Quelltext einer Beitragsseite, kopier den JSON-LD-Block heraus und füg ihn in einen Prüfdienst für strukturierte Daten ein. Welche es gibt, beantwortet die Frage Wie teste ich strukturierte Daten?. Dann stellst du drei Fragen: Verweisen die Knoten über @id aufeinander? Gibt es Felder ohne Wert? Steht alles, was ausgezeichnet ist, auch sichtbar auf der Seite? Fällt die Antwort Ja, Nein, Ja aus, ist die Grundlage in Ordnung.
Eine Erwartung solltest du dabei anpassen: Google garantiert nicht, dass strukturierte Daten in den Suchergebnissen angezeigt werden, auch wenn sie fehlerfrei sind [1]. Sie helfen Google, den Inhalt einer Seite zu verstehen und Angaben zu Personen oder Unternehmen einzuordnen [5].
Deine Seiten geben viele Einzelblöcke aus, und du weißt nicht, wo du anfangen sollst? Bring eine Beispielseite in die gratis Sprechstunde mit. Dann sprechen wir darüber, welche Verknüpfungen fehlen.
- Organisation Allgemeine Richtlinien für strukturierte Daten. Google Search Central. Stand 16.09.2026. abgerufen am 31.10.2026
- Organisation JSON-LD 1.1, W3C Recommendation, Abschnitt 1.7. W3C. Stand 16.07.2020. abgerufen am 31.10.2026
- Organisation sameAs. Schema.org. Stand 31.10.2026. abgerufen am 31.10.2026
- Organisation date_default_timezone_get. PHP-Handbuch, The PHP Group. Stand 31.10.2026. abgerufen am 31.10.2026
- Organisation Einführung in strukturierte Daten. Google Search Central. Stand 18.12.2025. abgerufen am 31.10.2026
Häufige Fragen
Sind mehrere JSON-LD-Blöcke auf einer Seite ein Fehler?
Kein Syntaxfehler, aber eine vertane Gelegenheit. Getrennte Blöcke verweisen in der Praxis selten aufeinander. Ein Block mit @graph bündelt alle Knoten und verknüpft sie über @id.
Bringt JSON-LD bessere Positionen?
Google beschreibt strukturierte Daten als Hilfe, den Inhalt einer Seite zu verstehen, und als Voraussetzung für Rich-Suchergebnisse. Eine Garantie für eine Anzeige gibt es nicht. Eine Rankingwirkung nennt Google auf seinen Seiten zu strukturierten Daten nicht.
Muss ich Mikrodaten zusätzlich einbauen?
Nein. Google empfiehlt JSON-LD. Zwei parallele Auszeichnungen desselben Sachverhalts laufen nach unserer Erfahrung früher oder später auseinander.
Woran erkenne ich eine stabile @id?
Sie ändert sich nicht zwischen zwei Bauvorgängen und ist auf allen Seiten für dieselbe Person oder Organisation gleich. Üblich ist die Adresse der Website mit einem Fragment, zum Beispiel #organization.
Noch eine Frage offen?
In der gratis Sprechstunde beantworten wir Fragen zu SEO live, jeden ersten Samstag im Monat um 18 Uhr. Oder du rufst einfach an.
Zuletzt geprüft am 03.11.2026, nächste Prüfung spätestens im November 2027. Fehler entdeckt? Schreib uns.
