TYPO3 Schema Markup hinzufügen: Strukturierte Daten in 3 Methoden

Kurzantwort: Wie fügt man Schema Markup in TYPO3 hinzu?

Kurzantwort: Fügen Sie Schema Markup in TYPO3 als JSON-LD hinzu, das aus Ihren Seitendaten erzeugt wird. Nutzen Sie für die meisten Websites die Extension brotkrueml/schema, für Sonderfälle eigene TypoScript- oder Fluid-Ausgabe und ein handgeschriebenes JSON-LD-HTML-Element nur für Einzelseiten. Prüfen Sie die gerenderte Seite danach mit dem Rich Results Test und dem Schema Markup Validator.

Wichtigste Punkte

• JSON-LD ist das in diesem Leitfaden empfohlene Format, weil es nicht von Ihrer HTML-Struktur abhängt.
• brotkrueml/schema 4.1.0 brachte die Kompatibilität mit TYPO3 v14. Laut Dokumentation der Extension werden TYPO3 v13 LTS und v14 LTS unterstützt.
• Im August 2023 beschränkte Google FAQ-Rich-Results auf bekannte Behörden- und Gesundheitswebsites, und HowTo-Rich-Results wurden im September 2023 eingestellt (Google Search Central Blog). FAQPage und HowTo bleiben gültige schema.org-Typen und sollten nur sichtbare Inhalte beschreiben. Prüfen Sie in der Google Search Gallery und der Search Console, was Google aktuell anzeigt.
• Validieren Sie die gerenderte Seite und nicht nur Ihr Template. Pro Schema-Typ sollte es genau eine Quelle geben.
• Werte wie Datum, Preis und Autor müssen mit dem sichtbaren Text der Seite übereinstimmen.

Getestet mit / gültig für: TYPO3 v13.4 LTS und v14 (brotkrueml/schema 4.x).
Aktualisiert: November 2026

Welche Methode sollten Sie wählen?

Wenn Sie nur eine schnelle Entscheidung wollen, verwenden Sie dies

Schnelle Entscheidungshilfe

• Wählen Sie Manuell, wenn Sie eine schnelle Ein-Seiten-Schema-Korrektur benötigen
• Wählen Sie Erweiterung, wenn Sie Automatisierung + Skalierbarkeit wünschen
• Wählen Sie Benutzerdefiniert, wenn Sie volle Kontrolle oder benutzerdefinierte Logik benötigen

Was ist Schema-Strukturierte Daten?

Schema-Strukturierte Daten ermöglichen es TYPO3-Seiten, maschinenlesbare Informationen anzuzeigen, die Suchmaschinen helfen, den Inhaltstyp Ihres Materials (Artikel, Produkt, Ereignis) zu identifizieren. Das System arbeitet nach dem Schema.org-Standard, den alle großen Suchmaschinen erkennen. 

Empfohlenes Format:

Verwenden Sie JSON-LD (JavaScript Object Notation for Linked Data). Es ist ein Skriptblock im Seitencode, der nicht von der HTML-Struktur abhängt.

Strukturierte Datenformate in TYPO3: JSON-LD vs Microdata vs RDFa

Beim Hinzufügen von Schema in TYPO3 ist die Wahl des richtigen Formats wichtig für Wartung, Skalierbarkeit und SEO-Kompatibilität.

Formatvergleich

Gemeinsame Schema-Typen für TYPO3-Websites

Nicht alle Schema-Typen führen zu Rich Results. Unten finden Sie eine prioritätsbasierte Struktur, die Ihnen hilft, sich auf das zu konzentrieren, was für TYPO3 SEO und Implementierung tatsächlich wichtig ist.

Hohe Priorität (Größter Einfluss + Häufige Verwendung)

1. Organisationsschema

• Beste Anwendungsfälle: Startseite, Über uns, Kontaktseiten
• Potenzial für Rich Results: Kein direkter Rich Result, unterstützt jedoch Marken-/Entitätsverständnis
• TYPO3-Hinweis: Global über TypoScript (page.headerData) oder Erweiterung hinzufügen

{
"@context": "https://schema.org",
"@type": "Organization",
"name": "T3Planet",
"url": "https://t3planet.de",
"logo": "https://t3planet.de/logo.svg"
}

2. Breadcrumb-Schema

• Beste Anwendungsfälle: Alle Seiten mit Hierarchie (Blogs, Kategorien)
• Potenzial für Rich Results: Breadcrumb-Anzeige in Suchergebnissen
• TYPO3-Hinweis: Oft dynamisch über Erweiterungen oder Menüstruktur generiert

{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://example.com/"
}]
}

3. Artikel-Schema

• Beste Anwendungsfälle: Blogbeiträge, Nachrichten (EXT:news)
• Potenzial für Rich Results: Berechtigt für erweiterte Auflistungen (nicht garantiert)
• TYPO3-Hinweis: Felder wie Titel

Mittlere Priorität (Anwendungsfallgesteuert)

4. Produktschema

• Bester Anwendungsfall: eCommerce-Seiten
• Potenzial für Rich Results: Preis, Bewertung, Verfügbarkeit
• TYPO3-Hinweis: Erfordert dynamische Daten (Preis, Lagerbestand, Bewertungen)

{
"@context": "https://schema.org",
"@type": "Product",
"name": "TYPO3-Erweiterung",
"offers": {
"@type": "Offer",
"price": "49.00",
"priceCurrency": "EUR"
}
}

5. Ereignisschema

• Bester Anwendungsfall: Webinare, Meetups, Konferenzen
• Potenzial für Rich Results: Veranstaltungslisten in der Suche
• TYPO3-Hinweis: Nützlich mit Veranstaltungserweiterungen oder benutzerdefinierten Inhaltstypen

{
"@context": "https://schema.org",
"@type": "Event", 
"name": "TYPO3 Meetup",
"startDate": "2026-12-10T18:00:00"
}

Optional / Selten ein Google-Rich-Result

6. FAQ-Schema

• Bester Anwendungsfall: Hilfeseiten, Dokumentation
• Potenzial für Rich Results: Begrenzt. Seit August 2023 zeigt Google FAQ-Rich-Results nur für bekannte Behörden- und Gesundheitswebsites; den aktuellen Stand zeigt die Google Search Gallery. Das Markup bleibt gültiges schema.org
• TYPO3-Hinweis: Optional; nur für Fragen, die auf der Seite sichtbar sind

{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "What is TYPO3 Schema?",
"acceptedAnswer": {
  "@type": "Answer",
  "text": "It helps search engines understand your content."
}
}]
}

Kurze Prioritätsübersicht

• Beginne mit: Organization + Breadcrumb + Article
• Füge dann hinzu: Product oder Event (basierend auf dem Website-Typ)
• Optional: FAQ (Rich Results seit August 2023 auf bekannte Behörden- und Gesundheitswebsites beschränkt)

Welche Schema-Typen passen zu welcher Seite?

Verwenden Sie auf jeder Website Organization und Breadcrumb und ergänzen Sie den Typ, der zur Seite passt: BlogPosting oder Article für Beiträge, Product für Shop-Artikel, Event für Termine. Welche Typen Google als Rich Result zeigt, entscheidet Google. Prüfen Sie daher die Google Search Gallery, bevor Sie mit einem Ergebnis planen.

Was hat sich bei FAQ- und HowTo-Rich-Results geändert?

Im August 2023 beschränkte Google FAQ-Rich-Results auf bekannte Behörden- und Gesundheitswebsites, und HowTo-Rich-Results wurden im September 2023 eingestellt (Google Search Central Blog). Google ändert laufend, welche Typen angezeigt werden. Prüfen Sie daher die Google Search Gallery und die Rich-Result-Berichte in der Search Console auf den aktuellen Stand. Beide Typen bleiben gültiges schema.org-Vokabular und sollten nur Inhalte beschreiben, die auf der Seite sichtbar sind, bestehendes Markup bricht also nicht.

Welche Schema-Typen sollten die meisten TYPO3-Seiten zuerst implementieren?

Hier ist ein schneller Leitfaden zur Priorisierung von Schemata entsprechend der Art der von Ihnen betriebenen Websites:

Informations- / Blog-Seiten

Priorität: Artikel + Breadcrumb + Organisation

Gründe:

• Artikel: beschreibt die Artikelstruktur (Titel, Autor, Datum)
• Breadcrumb: bessere Navigierbarkeit innerhalb der Suchergebnisse
• Organisation: liefert Marken-/Entitätssignale

TYPO3-Tipp: Artikel-Felder automatisch mit Fluid oder Schema-Erweiterung abbilden

Service- / Geschäftswebsites

Priorität: Organisation + Breadcrumb + Service / Lokales Markup

Gründe:

• Organisation: wesentlicher Bestandteil für eine Unternehmensidentität
• Breadcrumb: definiert die Seitenhierarchie
• Service / Lokal: erhöht die Relevanz von serviceorientierten Anfragen

TYPO3-Tipp: Organisation global hinzufügen, bei Bedarf zusätzliches Service- / Lokales Schema anwenden

eCommerce-Websites

Priorität: Produkt + Breadcrumb + Organisation

Gründe:

• Produkt: ermöglicht die Anzeige von Produktpreis, Verfügbarkeit und Bewertungen
• Breadcrumb: erleichtert das Kategoriebrowsing
• Organisation: sorgt für konsistente Markenbildung auf allen Webseiten

TYPO3-Tipp: Stellen Sie sicher, dass Produktinformationen (Preis, Lagerbestand) automatisch aktualisiert werden

Ereignisorientierte Websites

Priorität: Event + Organization + Breadcrumb

Gründe:

• Event: ermöglicht die Auflistung von Events in den SERPs (Zeit, Ort)
• Organization: identifiziert den Event-Veranstalter
• Breadcrumb: verbessert die Navigation innerhalb der Website-Inhalte

TYPO3-Tipp: Stelle sicher, dass alle Event-Daten aktuell sind, andernfalls wird das Schema ungültig

Schnelle Zusammenfassung

Fast alle TYPO3-Websites müssen zuerst Organization + Breadcrumb haben

Dann hinzufügen:

• Article, wenn die Website stark contentlastig ist
• Product, wenn es sich um eCommerce handelt
• Event, wenn sie eventbasiert ist

Überblick über die 3 besten Integrationsmethoden

Beginne mit einem kurzen Vergleich und wähle dann die Methode, die zur Komplexität und zum Workflow deines Projekts passt.

Vergleich zuerst

Kostenlose TYPO3-Leitfäden
Sie planen ein Upgrade, ein mehrsprachiges Setup oder Barrierefreiheit rund um Ihre strukturierten Daten? Laden Sie unsere praxisnahen TYPO3-Leitfäden kostenlos herunter.
Kostenlose TYPO3-Leitfäden ansehen

Methode 1: Manuelle statische Integration (HTML-Element-Methode)

Diese Methode eignet sich für begrenzte und statische Anwendungsfälle (einzelne Seite oder schnelle Experimente). 

Anwendungsfälle:

• Wenn Sie nur Schema zu einer oder zwei Seiten hinzufügen möchten und 
• Sie das Schema nicht dynamisch aktualisieren müssen.
• Sie haben keine TYPO3-Erweiterungen installiert, die es Ihnen ermöglichen würden, das Schema dynamisch zu integrieren. 

Funktionsweise:

• Sie fügen ein JSON-LD-Code-Snippet in ein Standard-HTML-Inhaltselement Ihrer TYPO3-Website ein. 
• Sie validieren dann das JSON-LD-Code-Snippet mit dem von Google bereitgestellten Rich Results Test. 

Einschränkungen:

Obwohl die Implementierung dieser Option für eine begrenzte Anzahl von Seiten funktioniert, bietet sie nicht die Möglichkeit zur Skalierung. 

Risiko von Inhaltsabweichungen:

• Wenn sich der Inhalt Ihrer Seite ändert (Preis, Autor, Datum usw.), wird Ihr Schema nicht automatisch aktualisiert, um diese Änderung widerzuspiegeln, was zu Diskrepanzen zwischen dem Inhalt Ihrer Seite und dem zugehörigen Schema führt. 
• Infolgedessen kann die Website aufgrund dieses Unterschieds kein Rich Result oder Leistungslisting anzeigen. 

Methode 2: Dynamische Integration mit TYPO3 Schema Extension

Diese Methode wird für die Mehrheit der TYPO3-Projekte empfohlen, da sie bereits diese Methode verwenden und es die empfohlene Option ist, um Schema dynamisch zu integrieren.

Funktionsweise:

Die TYPO3 Schema Extension (brotkrueml/schema) erstellt das Schema dynamisch auf Ihrer Website. Die TYPO3 Schema Extension greift direkt auf die Datenbankfelder in TYPO3 zu, sodass das Schema immer mit dem begleitenden Inhalt synchron bleibt. 

Diese Erweiterung unterstützt auch zahlreiche Schema-Typen und Erweiterungen.

Konfigurationsoptionen:

Kann konfiguriert werden über:

• TypoScript (globale Einrichtung)
• Fluid ViewHelpers (Kontrolle über die Template-Anzeige)
• Datenzuordnungen aus:
  • SEO-Feldern
  • Content-Elementen
  • benutzerdefinierten Feldern

Beispiel (TypoScript)

page = PAGE
page.10 = SCHEMA
page.10 {
type = WebSite
properties {
  name.field = seo_title
  description.field = description
}
}

Beispiel (Fluid)

<schema:type.organization
name="T3Planet"
url="https://t3planet.de"
logo="https://t3planet.de/logo.svg" />

Redakteure vs. Integratoren (wichtige Unterscheidung)

• Redakteure: verwalten Content-Felder (Titel, Beschreibung usw.)
• Integratoren/Entwickler: konfigurieren Schema-Zuordnung und Logik

Breadcrumb-Automatisierung

• Breadcrumb-Schema kann:
  • automatisch aus dem TYPO3-Seitenbaum generiert werden
  • über Extension-Einstellungen oder TypoScript konfiguriert werden

Vocabulary Extensions

• Add-ons wie:schema_auto
  • schema_auto
  • schema_bib
  • schema_health
• Nützlich für domainspezifische Structured Data

Häufige Stolperfallen

• Doppeltes Schema durch mehrere Extensions
• Fehlende erforderliche Eigenschaften

Falsche FeldzuordnungNützlich für domainspezifische Structured Data

Methode 3 – Benutzerdefinierte Integration mit TYPO3 Core

Am besten geeignet für: Fortgeschrittene, benutzerdefinierte oder Unternehmens-TYPO3-Projekte

Wann zu verwenden

• Mehrsprachige Setups
• Multi-Domain-Konfigurationen
• Benutzerdefinierte Entitäten, die von Erweiterungen nicht unterstützt werden
• Headless oder API-gesteuertes TYPO3

Option 1: TypoScript (Globale Injektion)

page.headerData {
100 = TEXT
100.value (
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "T3Planet",
    "url": "https://t3planet.de"
  }
  </script>
)
}

Option 2: Fluid (Template-Level-Kontrolle)

<f:asset.script identifier="schema-article" type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "{newsItem.title}",
"datePublished": "{newsItem.date -> f:format.date(format: 'Y-m-d')}"
}
</f:asset.script>

Warum benutzerdefinierte Integration verwenden

• Volle Kontrolle über:
  • Schema-Struktur
  • Bedingte Logik
  • Datenquellen
• Ideal für:
  • Mehrsprachige Schema-Ausgabe
  • Domainspezifische Schema-Variationen
  • Benutzerdefinierte APIs oder Headless-Setups

Häufige Stolperfallen (Benutzerdefinierte Integration)

• Manuelle Validierung erforderlich
• Höherer Wartungsaufwand
• Risiko von Syntaxfehlern oder unvollständigem Schema

Structured Data über Yoast SEO für TYPO3

Wenn du Yoast SEO für TYPO3 bereits verwendest, bietet es integrierte Structured-Data-Funktionen.

Wann du es in Betracht ziehen solltest

• Du verlässt dich bereits auf Yoast für SEO
• Du benötigst grundlegendes Schema (Organization, Article, Breadcrumb)

Einschränkungen

• Weniger flexibel als dedizierte Schema-Extensions
• Begrenzte Anpassungsmöglichkeiten für komplexe Schema-Typen

Von Google unterstützte Rich Results vs. Schema.org-Vokabular

• Schema.org = was du beschreiben kannst (Article, Product, Event usw.)
• Google Search Central = was in der Suche erscheinen kann (Rich Results)

Bei der Verwendung von Schema gibt es drei Dinge zu beachten.

Diese sind:

• Schema erzeugt möglicherweise kein Rich Snippet
• Das verwendete Schema ist möglicherweise kein unterstützter Typ
• Die Query-Intent-/Seitenqualität, die im Schema verwendet wird, ist möglicherweise nicht ausreichend.

Beachte außerdem, dass nicht jedes Rich Snippet von Google angezeigt wird. Es gibt Ausnahmen: Seit August 2023 zeigt Google FAQ-Rich-Results nur für bekannte Behörden- und Gesundheitswebsites.

Unterm Strich solltest du Schema korrekt verwenden und Googles Richtlinien befolgen, um zu prüfen, ob deine strukturierten Inhalte angezeigt werden können. Verlasse dich außerdem nicht darauf, dass auf Grundlage deiner strukturierten Inhalte ein Rich Snippet angezeigt wird.

Wie fügt man JSON-LD per TypoScript und Fluid hinzu?

Nutzen Sie das SCHEMA-Content-Objekt von brotkrueml/schema in TypoScript oder die Schema-ViewHelper in Fluid. Beide erzeugen das JSON-LD aus TYPO3-Daten und fügen es der Seitenausgabe hinzu. Die Beispiele folgen der offiziellen Dokumentation der Extension.

TypoScript: SCHEMA-Content-Objekt

Das Objekt fügt den Typ zur globalen Schema-Ausgabe hinzu und liest Werte aus Seitenfeldern. Der Fallback seo_title // title nimmt den Seitentitel, wenn kein SEO-Titel gesetzt ist.

page.10 = SCHEMA
page.10 {
   type = WebSite
   properties {
      name.field = seo_title // title
      description.field = description
   }
}

Fluid: Schema-ViewHelper

Die Typ-ViewHelper verwenden den Typnamen in lowerCamelCase, zum Beispiel schema:type.itemPage. Das Attribut -as ordnet einen verschachtelten Typ einer Eigenschaft des übergeordneten Typs zu.

<schema:type.itemPage>
   <schema:type.product
      -as="mainEntity"
      name="Some fancy product"
      color="blue"
   >
      <schema:type.aggregateRating
         -as="aggregateRating"
         ratingValue="4"
         reviewCount="126"
      />
   </schema:type.product>
</schema:type.itemPage>

Fluid ohne Extension: f:asset.script

Core-Fluid kann einen JSON-LD-Block mit f:asset.script ausgeben. Das Argument identifier ist Pflicht (ViewHelper-Referenz). Verwenden Sie pro Block einen eindeutigen Identifier, damit der AssetCollector ihn nur einmal ausgibt.

<f:asset.script identifier="ld-example" type="application/ld+json">
{
   "@context": "https://schema.org",
   "@type": "Organization",
   "name": "Example GmbH",
   "url": "https://example.com"
}
</f:asset.script>

Wie validiert man strukturierte Daten in TYPO3?

Validieren Sie die öffentliche URL mit drei Werkzeugen: dem Rich Results Test für die Google-Eignung, dem Schema Markup Validator für die schema.org-Syntax und der Google Search Console für die Live-Seite. Wiederholen Sie die Prüfung nach jedem Update von TYPO3 oder der Extension.

1. Erzeugtes Markup in TYPO3 prüfen. Mit brotkrueml/schema zeigt das Admin Panel die strukturierten Daten der aktuellen Seite. Nicht-Admin-Benutzer benötigen die User-TSconfig admPanel { enable { ext-schema = 1 } }.
2. Den Rich Results Test ausführen. Geben Sie die öffentliche URL ein. Er zeigt, für welche Google-Funktionen Ihr Markup infrage kommt, und listet Fehler und Warnungen.
3. Den Schema Markup Validator ausführen. Er prüft die schema.org-Syntax jedes Typs, auch von Typen ohne Google-Rich-Result.
4. Die Live-URL in der Google Search Console prüfen. Mit der URL-Prüfung sehen Sie, ob Google das Markup im gerenderten HTML erkennt. Prüfen Sie außerdem die Erweiterungsberichte der verwendeten Typen.
5. Mit der sichtbaren Seite abgleichen. Jeder Wert im Markup muss auf der Seite stehen. Prüfen Sie im Quelltext, dass jeder Typ nur einmal vorkommt.

Titel, Beschreibungen und Schema.org-Markup für viele Seiten von Hand zu schreiben, ist aufwendig. Der T3AI AI Assistant für TYPO3 unterstützt Redakteure bei SEO-Metadaten und strukturierten Daten direkt im TYPO3-Backend. Für Breadcrumb-Markup lesen Sie unseren Leitfaden zu SEO-freundlichen Breadcrumbs mit MenuProcessor und Fluid, und Alternativen finden Sie bei den besten TYPO3 SEO-Erweiterungen.

TYPO3 Schema-Start-Checkliste für die Implementierung strukturierter Daten

Um zu bestätigen, dass Ihr Schema in TYPO3 funktionsfähig, korrekt und bereit für Suchmaschinen ist, führen Sie den folgenden Pre-Launch-Workflow durch:  

Strukturierte Daten validieren

• Testen Sie JSON-LD mit folgendem:
  • Schema.org Validator
  • Google Search Central Rich Results Test
  • Beheben Sie alle Fehler (Warnungen können später überprüft werden).

Validierung der Live-URL (nicht nur Code)

• Verwenden Sie das URL-Inspektionstool in der Google Search Console
• Bestätigen Sie, dass das Schema vorhanden ist und nicht durch JS, Caching oder andere Elemente blockiert wird, wenn es im endgültigen HTML gerendert wird.

Schema-Duplikationsprüfung

• Überprüfen Sie den Seitenquelltext auf mehrere Schema-Blöcke desselben Typs auf der Seite.
• Bestätigen:
  • Keine Überlappung zwischen Erweiterungen
  • Keine manuelle und dynamische Duplikation

Übereinstimmung von Schema und sichtbarem Inhalt

• Stellen Sie sicher, dass alle strukturierten Daten auf der Seite dem tatsächlichen Inhalt auf der Seite entsprechen.
• Vermeiden:
  • Versteckte Daten
  • Veraltete Werte (zum Beispiel Preis, Datum, Autor)

Sprachkonsistenz über Versionen hinweg

• Für mehrsprachige TYPO3-Websites:
  • Stellen Sie sicher, dass die Sprache des Schemas mit der Sprache der Seite übereinstimmt
  • Stellen Sie sicher, dass die richtige URL für jede Sprachversion vorhanden ist
  • Vermeiden Sie gemischte Sprach-Eigenschaften

Überprüfung des Schema-Typs für die Seite

• Artikel = Blogbeiträge
• Produkt = Produktseiten
• Event = Eventseite

Identifiziere Schema nicht falsch, da dies die Berechtigung zur Anzeige von Structured Data verringern könnte.

Sichere und indexierbare Bereitstellung

• Stelle sicher, dass die bereitgestellte Webseite mit dem HTTPS-Protokoll gesichert ist.
• Prüfe, ob die Seite indexierbar ist (kein noindex verwendet).
• Stelle sicher, dass die Seite nicht durch robots.txt blockiert wird.

Vor und nach dem Rollout messen

In Google Search Console:

• Verfolge CTR-Änderungen
• Überwache Impressionen von Rich Results
• Überprüfe Erweiterungsberichte.

TYPO3 Leitfaden zur Fehlerbehebung bei strukturierten Daten für Schema-Probleme

Selbst bei korrekter Einrichtung können Schema-Probleme auftreten, insbesondere in TYPO3-Umgebungen mit mehreren Erweiterungen und dynamischen Inhalten. Verwenden Sie diese gezielten Lösungen:

1. Doppelte oder fehlende Schemas

• Stellen Sie sicher, dass Sie nur ein JSON-LD für jeden Schema-Typ auf einer einzelnen Webseite haben.
• Überprüfen Sie, ob Sie Duplikate erhalten von:
  • Eine Kombination aus mehreren Erweiterungen (z.B. ein SEO- und ein Schema-Plugin)
  • Kombination einer manuellen Methode mit einer automatischen Einfügemethode
• Deaktivieren eines überlappenden Anbieters oder Konsolidierung der Schema-Logik.

2. Unterstützte Eigenschaften

• Validieren Sie Ihre Feldwerte gegen Schema.org.
• Sie müssen die folgenden Arten von Eigenschaftswerten korrigieren:
  • Falsch geschriebene Eigenschaftswerte.
  • Veraltete oder nicht unterstützte Eigenschaftswerte.
  • Falsche Datentypen von Eigenschaftswerten (z.B. ein String, wo es eine Zahl sein sollte).

3. Veraltete TYPO3-Erweiterung und Erweiterungskonflikte

• Stellen Sie sicher, dass Ihre TYPO3-Erweiterungen (z.B. die brotkrueml/schema-Erweiterung) aktualisiert sind.
• Überprüfen Sie auf Folgendes:
  • Vorwiegend Erweiterungskonflikte (typischerweise mit Ihren Suchmaschinenoptimierungserweiterungen).
  • Fehlerhafte Zuordnungen nach dem Aktualisieren von TYPO3.
• Sie müssen alle Schemas nach jedem Update validieren.

4. JSON-Formatierungsfehler

• Verwende ein Linter-Tool oder den Google Rich Results Test, um dein JSON zu validieren.

• Einige häufige Beispiele für JSON-Formatierungsfehler, die du sehen wirst:

  • Fehlende Kommas
  • Fehlende Klammern
  • Falsche Anführungszeichen
  • Zusätzliche Kommas

5. Schema-Abweichung zwischen sichtbarem und verborgenem Inhalt

• Das Schema, das du sendest, sollte mit dem übereinstimmen, was Nutzer auf der Seite sehen.

• Vermeide das Senden von:

  • Verborgenen Inhalten.
  • Veralteten Inhalten.
• Anzeigeinhalten wie Bewertungen, Preisen oder Daten, die dem Nutzer nicht angezeigt werden.
• Eine Abweichung zwischen dem Schema und dem sichtbaren Inhalt entfernt die Berechtigung für Rich Search Results.

6. Veraltete dynamische Felder (z. B. Produkte und Events)

• Stelle sicher, dass die Felder, die sich auf Elemente beziehen wie:

  • Preise
  • Verfügbarkeit von Produkten
  • Event-Daten
• automatisch abhängig vom Inhalt in TYPO3 aktualisiert werden.
• Ein abgelaufenes Event oder ein falscher Preis führt dazu, dass das Schema ungültig wird.

7. Mehrsprachiges Schema mit zwei Sprachen

• Prüfe Folgendes:

  • Die Schema-Sprache muss mit der Sprache der Webseite übereinstimmen
  • Lokalisierte URL
  • Keine gemischten Sprachen in der Eigenschaft vorhanden
  • Erstelle ein separates Schema-Rendering für jede Sprache in TYPO3

8. Erwartungsabweichung bei FAQ Rich Snippets

• Selbst gültiges FAQ-Schema wird möglicherweise nicht in der Suche angezeigt

• Gründe:

  • durch Google-Richtlinien eingeschränkt
  • Website wird nicht als autoritativ eingestuft

• Validiere über Google Search Central und passe die Erwartungen an.

Beste Praktiken für die Integration von TYPO3-Schema

Befolgen Sie diese, um Ihre strukturierten Daten stabil, genau und skalierbar zu halten:

1. Erweiterungen aktualisieren

• Verwenden Sie immer die aktuelle Version von brotkrueml/schema oder anderen verwandten Erweiterungen.
• Updates beheben vorhandene Fehler und verbessern die Kompatibilität mit Schemas.

2. Verwenden Sie dynamische Werte aus TYPO3-Feldern

• Ordnen Sie den Titel, die Beschreibung, den Preis, das Datum usw. direkt aus dem Content-Management-System (CMS) dem entsprechenden Schema-Element zu. 
• Dies hilft sicherzustellen, dass das Schema nicht veraltet ist.

3. Zentralisieren Sie die Schema-Logik

• Aktualisieren Sie das Schema nur an einem Ort statt an mehreren Stellen. Die gesamte Schema-Logik sollte verwaltet werden durch:
  • TypoScript
  • Fluid-Templates
  • Erweiterungen
• Dies hilft, doppelte Arbeit und Fehler zu reduzieren.

4. Validieren Sie nach TYPO3-Upgrades

• Verwenden Sie die Tools von Google Search Central, um nach Updates in TYPO3 eine zusätzliche Validierungsprüfung des Schemas durchzuführen, um sicherzustellen, dass sowohl das Rendering als auch die Erkennung der Elemente weiterhin ordnungsgemäß funktionieren.

5. Sichern Sie Schema-Templates

• Halten Sie eine versionierte Sicherung von beiden:
  • TypoScript
  • Fluid-Templates
• Dies erleichtert die Wiederherstellung bei Problemen.

Reale Implementierungsbeispiele nach Seitentyp

Diese Beispiele zeigen, wie Schema tatsächlich in TYPO3-Projekten angewendet wird, abgestimmt auf reale Anwendungsfälle.

Blog / Nachrichten-Website

Typisches Schema:

• Article + Breadcrumb + Organization

Implementierungsansatz:

• Verwende Extension oder Fluid, um Folgendes zuzuordnen:
  • title: headline
  • author: Person
  • publish date: datePublished

Beispiel (Fluid):

<f:asset.script identifier="schema-article-author" type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "Article",
 "headline": "{newsItem.title}",
 "datePublished": "{newsItem.date}",
 "author": {
   "@type": "Person",
   "name": "{newsItem.author}"
 }
}
</f:asset.script>

Unternehmens-/Business-Website

Typisches Schema:

• Organization + Breadcrumb

Implementierungsansatz:

• Füge Organization global über TypoScript hinzu
• Halte Unternehmensdetails über alle Seiten hinweg konsistent

Beispiel (TypoScript):

page.headerData {
100 = TEXT
100.value (
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Company Name",
    "url": "https://example.com"
  }
  </script>
)
}

Produkt / E-Commerce-Website

Typisches Schema:

• Produkt + Breadcrumb + Organisation

Implementierungsansatz:

• Dynamische Daten abrufen:
  • Preis
  • Verfügbarkeit
  • Bewertungen

Beispiel:

{
"@context": "https://schema.org",
"@type": "Product",
"name": "{product.title}",
"offers": {
 "@type": "Offer",
 "price": "{product.price}",
 "priceCurrency": "EUR",
 "availability": "https://schema.org/InStock"
}
}

Wichtige Anforderung:

• Werte mit aktuellen Produktdaten synchron halten, um Abweichungen zu vermeiden

Veranstaltungsseite

Typisches Schema:

• Veranstaltung + Organisation + Breadcrumb

Implementierungsansatz:

• Veranstaltungsfelder zuordnen:
  • Name
  • Start-/Enddatum
  • Ort

Beispiel:

{
"@context": "https://schema.org",
"@type": "Event",
"name": "{event.title}",
"startDate": "{event.startDate}",
"endDate": "{event.endDate}"
}

Wichtige Anforderung:

• Abgelaufene Events immer aktualisieren oder entfernen

Praxisbeispiele für Schema in TYPO3

Nachfolgend findest du vereinfachte, implementierungsorientierte Beispiele, die zeigen, wie Schema in TYPO3 tatsächlich mit verschiedenen Methoden verwendet wird.

FAQ-Schema (Blog-Anwendungsfall)

Anwendungsfall: Blogbeiträge oder Dokumentationsseiten mit Q&A-Bereichen

Methode: TYPO3 Extension oder Fluid (dynamische Content-Zuordnung)

Beispiel (Fluid)

<f:asset.script identifier="schema-faqpage" type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
  "@type": "Question",
  "name": "{faq.question}",
  "acceptedAnswer": {
    "@type": "Answer",
    "text": "{faq.answer}"
  }
}]
}
</f:asset.script>

Brotkrümel-Schema (Navigationsanwendungsfall)

Anwendungsfall: Alle TYPO3-Seiten mit Seitenhierarchie
Methode: TypoScript (globale Seitenstruktur)

Beispiel (TypoScript)

page.headerData {
 200 = TEXT
 200.value (
   <script type="application/ld+json"></code><br><code class="language-javascript">   {</code><br><code class="language-javascript">     &quot;@context&quot;: &quot;https://schema.org&quot;,</code><br><code class="language-javascript">     &quot;@type&quot;: &quot;BreadcrumbList&quot;,</code><br><code class="language-javascript">     &quot;itemListElement&quot;: [{</code><br><code class="language-javascript">       &quot;@type&quot;: &quot;ListItem&quot;,</code><br><code class="language-javascript">       &quot;position&quot;: 1,</code><br><code class="language-javascript">       &quot;name&quot;: &quot;Home&quot;,</code><br><code class="language-javascript">       &quot;item&quot;: &quot;https://example.com/&quot;</code><br><code class="language-javascript">     }]</code><br><code class="language-javascript">   }</code><br><code class="language-javascript">   </script>
   )
}

Produkt-Schema (eCommerce-Anwendungsfall)

Anwendungsfall: Produktdetailseiten in TYPO3-Shops
Methode: TYPO3 Schema-Erweiterung (dynamische Zuordnung)

Beispiel (Erweiterungsbasiertes Konzept)

{
 "@context": "https://schema.org",
 "@type": "Product",
 "name": "{product.title}",
 "offers": {
   "@type": "Offer",
   "price": "{product.price}",
   "priceCurrency": "EUR"
 }
}

Warum hier eine Erweiterung:
Hält Produktdaten (Preis, Lagerbestand, Verfügbarkeit) automatisch synchron mit TYPO3-Inhalten.

Organisationsschema (Globale Seitenidentität)

Anwendungsfall: Jede TYPO3-Website (Header/Footer/globale Identität)
Methode: TypoScript oder Erweiterung

Beispiel (TypoScript, Organisationsschema)

page.headerData {
 100 = TEXT
 100.value (
   <script type="application/ld+json"></code><br><code class="language-javascript">   {</code><br><code class="language-javascript">     &quot;@context&quot;: &quot;https://schema.org&quot;,</code><br><code class="language-javascript">     &quot;@type&quot;: &quot;Organization&quot;,</code><br><code class="language-javascript">     &quot;name&quot;: &quot;Firmenname&quot;,</code><br><code class="language-javascript">     &quot;url&quot;: &quot;https://example.com&quot;</code><br><code class="language-javascript">   }</code><br><code class="language-javascript">   &lt;/script&amp;gt</script>

Event-Schema (Event-Anwendungsfall)

Anwendungsfall: Meetups, Webinare, Konferenzen
Methode: Erweiterung oder Fluid (dynamische Ereignisdatensätze)

Beispiel (Fluid, Event-Schema)

<f:asset.script identifier="schema-event" type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "Event",
 "name": "{event.title}",
 "startDate": "{event.startDate}",
 "endDate": "{event.endDate}",
 "location": {
   "@type": "Place",
   "name": "{event.location}"
 }
}
</f:asset.script>

Fazit

Schema in TYPO3 sollte regelmäßig geprüft, validiert und an Änderungen der Inhalte angepasst werden. Die AI Foundation für TYPO3 kann ergänzend kontrollierte KI-Workflows unterstützen, die strukturierte Inhalte analysieren oder bei der Erstellung passender Schema-Daten helfen.

Nächste Schritte

1. Wählen Sie eine Methode (Manuell, Erweiterung oder Benutzerdefiniert)
2. Fügen Sie JSON-LD konsequent hinzu auf relevanten Seiten
3. Validieren Sie vor der Veröffentlichung mit Google-Tools
4. Überwachen Sie die Ergebnisse in der Google Search Console (CTR, Rich Results, Fehler)

Dies stellt sicher, dass Ihre strukturierten Daten genau, indexierbar und im Einklang mit TYPO3-Inhaltsänderungen im Laufe der Zeit bleiben.

Weitere Fragen zu TYPO3 Schema Markup

Brauche ich eine Extension, um Schema Markup in TYPO3 hinzuzufügen?

Nein. Sie können JSON-LD mit einem HTML-Inhaltselement, TypoScript oder Fluid ausgeben. Eine Extension wie brotkrueml/schema ergänzt eine typisierte PHP-API, ein TypoScript-Objekt SCHEMA, Fluid-ViewHelper und eine Admin-Panel-Ansicht des erzeugten Markups. Das reduziert veraltetes und doppeltes Markup auf größeren Websites.

Hilft FAQ-Schema 2026 noch?

Für das Suchergebnis nur selten. Seit August 2023 zeigt Google FAQ-Rich-Results nur noch für bekannte Behörden- und Gesundheitswebsites, und HowTo-Rich-Results wurden im September 2023 eingestellt (Google Search Central Blog). Google ändert laufend, welche Typen angezeigt werden. Prüfen Sie daher die Google Search Gallery und die Search Console. FAQPage-Markup bleibt gültiges schema.org und sollte nur sichtbare Fragen und Antworten beschreiben, aber kein Grund für zusätzliche FAQ-Blöcke sein.

Welche TYPO3-Versionen unterstützt brotkrueml/schema?

Die Dokumentation nennt TYPO3 v13 LTS und v14 LTS. Version 4.0 entfernte TYPO3 v11 und v12, Version 4.1.0 brachte die Kompatibilität mit v14. Die Installation im Composer-Modus erfolgt mit composer req brotkrueml/schema.

Kann ich zwei Schema-Extensions auf derselben Website nutzen?

Das ist möglich, erzeugt aber oft doppeltes oder widersprüchliches Markup, etwa zwei Organization-Blöcke. Wählen Sie pro Schema-Typ einen Anbieter, deaktivieren Sie überschneidende Ausgaben von SEO-Extensions und prüfen Sie nach jeder Änderung den Quelltext.

Warum erscheint mein gültiges Markup nicht als Rich Result?

Gültiges Markup macht eine Seite nur teilnahmeberechtigt. Ob Google ein Rich Result zeigt, entscheidet Google, und für manche Typen gibt es keines mehr. Prüfen Sie, ob der Typ in der Google Search Gallery steht, ob der Inhalt auf der Seite sichtbar ist und ob die Seite indexierbar ist.

Kostenlose TYPO3-Leitfäden erhalten
Halten Sie Ihr TYPO3-Projekt aktuell und Ihre strukturierten Daten nach Upgrades stabil, mit unseren kostenlosen Praxisleitfäden.
Kostenlose TYPO3-Leitfäden herunterladen