JSON-LD in Website einbinden – Anleitung

Sie haben strukturierte Daten für Ihr Unternehmen erstellt und halten nun eine JSON-LD-Datei in den Händen. Der nächste Schritt ist entscheidend: Das Markup muss an die richtige Stelle in Ihre Website. Nur dann können Google und andere Suchmaschinen die Informationen auslesen und in den Suchergebnissen nutzen.

Diese Anleitung zeigt Ihnen genau, wie Sie JSON-LD in Ihre Website einbinden – unabhängig davon, ob Sie WordPress, einen Website-Baukasten oder eine handgeschriebene HTML-Seite nutzen. Die gute Nachricht: Es ist technisch einfacher als gedacht. Sie müssen kein Entwickler sein.

Was ist JSON-LD und warum gehört es in den Head-Bereich?

JSON-LD steht für JavaScript Object Notation for Linked Data. Es ist ein Format, mit dem Sie Maschinen wie Google mitteilen, was Ihr Unternehmen tut, wo es sich befindet und welche Leistungen Sie anbieten. Das Markup ist reiner Text und wird in einem <script>-Tag mit dem Typ application/ld+json verpackt.

Die Platzierung ist klar definiert: JSON-LD gehört in den <head>-Bereich Ihrer Website. Dort wird es beim Laden der Seite von Suchmaschinen ausgelesen, ohne dass es für Besucher sichtbar ist. Es verändert nichts am Design oder der Funktion Ihrer Seite – es liefert nur zusätzliche Informationen im Hintergrund.

Alternativ können Sie JSON-LD auch am Ende der Seite vor dem schließenden </body>-Tag einfügen. Google liest beide Positionen aus. Der Head-Bereich wird aber von den meisten Dokumentationen als Standard empfohlen, da Crawler dort zuerst nach strukturierten Daten suchen.

Wo genau muss der Code eingefügt werden?

Wenn Sie sich den Quellcode Ihrer Website ansehen (Rechtsklick auf die Seite, dann „Seitenquelltext anzeigen"), sehen Sie ganz oben einen Bereich, der mit <head> beginnt und mit </head> endet. Genau dort muss Ihr JSON-LD-Code eingefügt werden.

Ein typisches Beispiel sieht so aus:

<!DOCTYPE html>
<html lang="de">
<head>
  <meta charset="UTF-8">
  <title>Musterfirma GmbH – Dachdecker in München</title>
  
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "LocalBusiness",
    "name": "Musterfirma GmbH",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "Musterstraße 12",
      "postalCode": "80331",
      "addressLocality": "München"
    },
    "telephone": "+49 89 12345678"
  }
  </script>
  
</head>
<body>
  <!-- Hier beginnt der sichtbare Inhalt -->
</body>
</html>

Das <script type="application/ld+json">-Tag ist das entscheidende Element. Es teilt dem Browser und den Suchmaschinen mit: „Hier kommt maschinenlesbarer Code, aber kein JavaScript zum Ausführen."

JSON-LD in WordPress einbinden

WordPress ist das meistgenutzte CMS in Deutschland, und die Einbindung von JSON-LD ist hier besonders einfach. Sie haben zwei Möglichkeiten: manuell über das Theme oder automatisch über ein Plugin.

Manuell über das Theme (für fortgeschrittene Nutzer)

Wenn Sie Zugriff auf die Theme-Dateien haben, können Sie JSON-LD direkt in die header.php einfügen. Gehen Sie in WordPress zu „Design" → „Theme-Datei-Editor" und öffnen Sie die Datei header.php. Suchen Sie dort nach der Zeile </head> und fügen Sie direkt davor Ihren JSON-LD-Code ein.

Wichtig: Bearbeiten Sie niemals Theme-Dateien ohne Backup. Wenn Sie einen Fehler machen, kann die Website unbenutzbar werden. Nutzen Sie ein Child-Theme, damit Ihre Änderungen bei Theme-Updates nicht überschrieben werden.

Mit einem Plugin (empfohlen für die meisten Nutzer)

Der sicherere und einfachere Weg führt über ein Plugin wie „Insert Headers and Footers" oder „WPCode". Nach der Installation finden Sie ein neues Menü in WordPress, in dem Sie Code in den Head-Bereich einfügen können, ohne Theme-Dateien zu berühren.

So gehen Sie vor:

Installieren Sie das Plugin „Insert Headers and Footers" über „Plugins" → „Installieren"
Gehen Sie nach der Aktivierung zu „Einstellungen" → „Insert Headers and Footers"
Fügen Sie Ihren JSON-LD-Code in das Feld „Scripts in Header" ein
Klicken Sie auf „Speichern"

Das Plugin fügt den Code automatisch in den Head-Bereich aller Seiten ein. Für unterschiedliche Standorte oder Seiten benötigen Sie ein fortgeschritteneres Plugin wie WPCode, das Bedingungen unterstützt.

Spezielle Schema-Plugins: Yoast und RankMath

Viele WordPress-Nutzer haben bereits Yoast SEO oder RankMath installiert. Diese Plugins generieren automatisch Schema.org Markup aus den vorhandenen Daten Ihrer Website – allerdings oft sehr generisch und unvollständig.

Wenn Sie ein detailliertes LocalBusiness-Schema mit Öffnungszeiten, Leistungen und FAQs einbinden möchten, reichen diese Plugins nicht aus. Sie können dann entweder das vorhandene Schema durch manuelles JSON-LD ergänzen oder das Plugin-Schema deaktivieren und komplett durch Ihr eigenes ersetzen.

In Yoast deaktivieren Sie das Schema unter „SEO" → „Darstellung in der Suche" → „Allgemein" → „Schema.org Daten". In RankMath finden Sie die Option unter „Rank Math SEO" → „Titles & Meta" → „Local SEO".

JSON-LD in HTML-Websites ohne CMS einbinden

Wenn Ihre Website aus reinen HTML-Dateien besteht (kein WordPress, kein CMS), ist die Einbindung noch direkter. Sie bearbeiten einfach die entsprechende HTML-Datei und fügen das JSON-LD ein.

Öffnen Sie die Datei (meist index.html oder die jeweilige Unterseite) in einem Texteditor. Suchen Sie nach dem </head>-Tag und fügen Sie direkt davor Ihr JSON-LD-Script ein. Speichern Sie die Datei und laden Sie sie per FTP auf Ihren Server hoch.

Wichtig: JSON-LD funktioniert nur auf live im Internet erreichbaren Seiten. Wenn Sie die HTML-Datei lokal auf Ihrem Computer öffnen (per file://-Protokoll), können Google und andere Crawler sie nicht auslesen.

JSON-LD in Website-Baukästen einbinden (Wix, Jimdo, Webflow)

Website-Baukästen haben oft eingeschränkte Möglichkeiten, eigenen Code einzufügen. Die Optionen unterscheiden sich je nach Anbieter.

Wix

Wix erlaubt das Einfügen von Custom Code nur im Premium-Tarif. Gehen Sie zu „Einstellungen" → „Custom Code" → „Code zu Head hinzufügen". Fügen Sie dort Ihr JSON-LD ein und stellen Sie sicher, dass „Auf allen Seiten laden" aktiviert ist, sofern das Schema für die gesamte Website gilt.

Jimdo

Bei Jimdo finden Sie die Option unter „Einstellungen" → „Head bearbeiten". Dort können Sie HTML-Code einfügen. Denken Sie daran, dass Ihr JSON-LD in <script type="application/ld+json">-Tags eingebettet sein muss.

Webflow

Webflow bietet unter „Project Settings" → „Custom Code" ein Feld für Head-Code. Hier können Sie JSON-LD projektbewusst einfügen. Für seitenspezifisches Schema gehen Sie zur jeweiligen Seite und öffnen die „Page Settings" → „Custom Code".

Beachten Sie, dass nicht alle Baukasten-Anbieter Custom Code erlauben. Kostenlose Tarife sind oft eingeschränkt. Prüfen Sie die Dokumentation Ihres Anbieters.

Mehrere JSON-LD-Blöcke auf einer Seite

Sie können mehrere JSON-LD-Blöcke auf einer Seite einbinden. Das ist sogar empfohlen, wenn Sie unterschiedliche Entitäten beschreiben möchten – zum Beispiel Ihr LocalBusiness-Schema, ein zusätzliches FAQPage-Schema und ein BreadcrumbList-Schema.

Jeder Block steht in einem eigenen <script type="application/ld+json">-Tag:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Musterfirma GmbH"
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Wie lange dauert eine Dachreparatur?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Eine Standardreparatur dauert in der Regel 2-4 Stunden."
      }
    }
  ]
}
</script>

Google verarbeitet alle Blöcke separat. Achten Sie darauf, dass jeder Block syntaktisch korrekt ist. Ein Fehler in einem Block kann die Verarbeitung aller Blöcke beeinträchtigen.

Häufige Fehler beim Einbinden von JSON-LD

Auch wenn die Einbindung technisch einfach ist, gibt es typische Stolperfallen:

Fehlender oder falscher Script-Typ: Wenn Sie <script> ohne den Zusatz type="application/ld+json" verwenden, interpretiert der Browser das JSON als JavaScript und es kommt zu Fehlern. Der korrekte Typ ist zwingend erforderlich.

Ungültiges JSON-Format: JSON ist sehr streng bei der Syntax. Ein fehlendes Komma, ein Anführungszeichen zu viel oder ein nicht geschlossenes Klammerpaar führt dazu, dass Google den gesamten Block ignoriert. Nutzen Sie einen JSON-Validator wie jsonlint.com, um Ihr Markup vor dem Einfügen zu prüfen.

Sonderzeichen nicht maskiert: Wenn in Ihrem Text Anführungszeichen vorkommen (z.B. in der Unternehmensbeschreibung), müssen diese mit einem Backslash maskiert werden: \". Andernfalls bricht das JSON-Format ab.

JSON-LD am falschen Ort: Manche Nutzer fügen JSON-LD in den sichtbaren Seiteninhalt ein. Das führt dazu, dass der Code als Text auf der Seite erscheint. JSON-LD gehört in den Head-Bereich oder kurz vor </body>, niemals in den Content-Bereich.

Veraltete Schema.org-Typen: Schema.org entwickelt sich weiter. Veraltete Properties oder Typen können zu Warnungen in der Google Search Console führen. Nutzen Sie immer die aktuelle Spezifikation von schema.org.

Nach dem Einbinden: Testen und Validieren

Sobald Sie JSON-LD eingebunden haben, sollten Sie überprüfen, ob Google es korrekt ausliest. Google bietet dafür zwei kostenlose Tools an.

Rich Results Test: Unter search.google.com/test/rich-results können Sie die URL Ihrer Website eingeben. Google crawlt die Seite und zeigt an, welche strukturierten Daten gefunden wurden. Wenn Fehler oder Warnungen erscheinen, erklärt das Tool, was korrigiert werden muss.

Google Search Console: Wenn Sie Ihre Website in der Search Console verifiziert haben, finden Sie unter „Verbesserungen" einen Bericht zu strukturierten Daten. Dort sehen Sie, auf welchen Seiten Schema erkannt wurde und ob Fehler vorliegen. Dieser Bericht wird regelmäßig aktualisiert, sobald Google Ihre Seite neu crawlt.

Beide Tools zeigen auch eine Vorschau, wie Ihr Suchergebnis mit Rich Snippets aussehen könnte. Beachten Sie, dass Google Rich Snippets nicht garantiert – die Anzeige hängt von vielen Faktoren ab. Korrekt eingebundenes Schema erhöht aber die Wahrscheinlichkeit deutlich.

Wie oft sollte JSON-LD aktualisiert werden?

Strukturierte Daten sind keine einmalige Aufgabe. Wenn sich Ihre Öffnungszeiten ändern, Sie eine neue Telefonnummer erhalten oder Ihr Leistungsangebot erweitern, muss das JSON-LD angepasst werden.

Veraltete Daten im Schema können schlimmer sein als gar keine strukturierten Daten. Wenn Google in Ihrem Schema Öffnungszeiten anzeigt, die nicht stimmen, verlieren Sie Vertrauen bei potenziellen Kunden. Planen Sie mindestens einmal pro Quartal eine Überprüfung ein.

Wenn Sie Änderungen vornehmen, müssen Sie das JSON-LD an derselben Stelle aktualisieren, an der Sie es ursprünglich eingefügt haben. Bei WordPress-Plugins bedeutet das: Zurück in die Plugin-Einstellungen. Bei HTML-Dateien: Die Datei bearbeiten und erneut hochladen.

FirmSpec: JSON-LD generieren und direkt nutzen

Wenn Sie bis hierhin gelesen haben, wissen Sie jetzt, wie JSON-LD technisch eingebunden wird. Der aufwändigere Teil ist oft die Erstellung des Markups selbst – besonders wenn Sie nicht nur die Grunddaten, sondern auch Öffnungszeiten, FAQs, Leistungen und Qualifikationen maschinenlesbar machen möchten.

FirmSpec ist ein kostenloses Browser-Tool, das strukturierte Unternehmensdaten für deutsche KMU erzeugt. Es führt Sie durch 44 branchenspezifische Vorlagen und generiert am Ende fertiges JSON-LD, das Sie direkt kopieren und in Ihre Website einfügen können – genau so, wie in dieser Anleitung beschrieben.

Das Tool läuft vollständig im Browser, speichert keine Daten auf einem Server und erfordert keine Anmeldung. Sie erhalten nicht nur Schema.org JSON-LD, sondern auch llms.txt für KI-Systeme, ein FAQ-Schema und weitere Formate. Der Vollständigkeits-Score zeigt Ihnen, welche Felder noch fehlen, um das Maximum an Sichtbarkeit herauszuholen.

Zusammenfassung: Die wichtigsten Schritte

JSON-LD in eine Website einzubinden ist keine Raketenwissenschaft. Sie benötigen drei Dinge: Ihr fertiges JSON-LD-Markup, Zugriff auf den Head-Bereich Ihrer Website und ein Validierungstool, um das Ergebnis zu prüfen.

Für WordPress-Nutzer ist ein Plugin wie „Insert Headers and Footers" der sicherste Weg. Bei HTML-Websites fügen Sie den Code direkt vor </head> ein. Bei Website-Baukästen nutzen Sie die Custom-Code-Funktion, sofern verfügbar.

Nach dem Einbinden testen Sie mit dem Rich Results Test von Google, ob alles korrekt erkannt wird. Aktualisieren Sie Ihr Schema regelmäßig, wenn sich Unternehmensdaten ändern. So stellen Sie sicher, dass Google und andere Suchmaschinen immer die aktuellen Informationen über Ihr Unternehmen haben – und diese in den Suchergebnissen nutzen können.

JSON-LD in Website einbinden: Praktische Anleitung für lokale Unternehmen