FAQ-Schema einbauen: Anleitung mit Code

Voraussetzungen

Bevor du mit der Implementierung beginnst, stelle sicher, dass folgende Punkte erfüllt sind:

• Zugriff auf den Quellcode deiner Website oder Zugang zum CMS (WordPress, Webflow, Shopify etc.)
• Mindestens 2 bis 3 echte FAQ-Einträge auf der Zielseite, Google empfiehlt, dass die Fragen und Antworten auch sichtbar im HTML der Seite stehen
• Ein Google Search Console Konto, das mit deiner Domain verknüpft ist (für spätere Verifizierung)
• Grundkenntnisse in HTML, du musst lediglich einen <script>-Block in dein HTML einfügen
• Die Seite muss von Google indexiert sein oder indexierbar sein (kein noindex-Tag)

Lohnt sich FAQ Schema noch, wenn Google kaum FAQ Rich Results zeigt?

Seit August 2023 zeigt Google die aufklappbaren FAQ Rich Results in der normalen Suche nur noch für wenige, sehr vertrauenswürdige Websites an, vor allem Behörden- und Gesundheitsportale. Für eine typische B2B-Website solltest du also nicht mit zusätzlichen Fragen unter deinem Suchergebnis rechnen. Das Markup bleibt trotzdem sinnvoll, nur aus einem anderen Grund.

KI-Systeme wie Google AI Overviews, ChatGPT oder Perplexity bevorzugen Inhalte, die eine Frage direkt und abgeschlossen beantworten. FAQPage-Markup markiert genau diese Einheiten eindeutig: Frage in name, Antwort in text, ohne dass ein Sprachmodell den Zusammenhang erst aus Fließtext herauslösen muss. Damit ist FAQ Schema eine der wenigen technischen Maßnahmen für Generative Engine Optimization, die du mit wenig Aufwand direkt umsetzen kannst. Ein Garant für Zitate ist es nicht, Inhaltsqualität und Entity-Signale zählen genauso. Welche weiteren Schema-Typen KI-Systeme gut verwerten, zeigt der Beitrag Schema.org für GEO.

FAQPage, QAPage oder HowTo: welcher Typ passt?

• FAQPage: Du beantwortest als Betreiber redaktionell ausgewählte Fragen, jede mit genau einer offiziellen Antwort. Typisch für Leistungsseiten, Ratgeber und Support-Bereiche.
• QAPage: Nutzer stellen Fragen und mehrere Personen antworten, wie in Foren oder Community-Plattformen. Antworten aus Kommentaren oder anderen nutzergenerierten Inhalten gehören nicht in FAQPage.
• HowTo: Die Seite beschreibt einen Ablauf in aufeinanderfolgenden Schritten. Dafür ist HowTo Schema der passende Typ, FAQPage eignet sich nur für einzelne, eigenständige Fragen.

Schritt-für-Schritt Anleitung

Schritt 1: FAQ-Inhalte auf der Seite sichtbar einbauen

Google verlangt, dass die Fragen und Antworten, die du im Schema markierst, auch für den Nutzer sichtbar auf der Seite erscheinen. Füge deine FAQs zunächst als normalen HTML-Content ein:

<div class='faq-section'>
 <h3>Was ist FAQ Schema?</h3>
 <p>FAQ Schema ist ein strukturiertes Datenformat, das Google hilft,
 Fragen und Antworten auf deiner Seite zu erkennen.</p>

 <h3>Wie implementiere ich FAQ Schema?</h3>
 <p>Du fügst einen JSON-LD Script-Block in den <head> oder <body>
 deiner Seite ein.</p>
</div>

Schritt 2: JSON-LD Grundstruktur erstellen

Erstelle nun den JSON-LD Block. JSON-LD ist das von Google empfohlene Format für strukturierte Daten. Öffne einen Texteditor und beginne mit dieser Grundstruktur:

<script type='application/ld+json'>
{
 "@context": "https://schema.org",
 "@type": "FAQPage",
 "mainEntity": []
}
</script>

Das @type-Feld muss exakt FAQPage lauten, Groß- und Kleinschreibung beachten.

Schritt 3: Fragen und Antworten als mainEntity eintragen

Fülle das mainEntity-Array mit deinen FAQ-Einträgen. Jeder Eintrag hat den Typ Question und enthält ein acceptedAnswer-Objekt:

<script type='application/ld+json'>
{
 "@context": "https://schema.org",
 "@type": "FAQPage",
 "mainEntity": [
 {
 "@type": "Question",
 "name": "Was ist FAQ Schema?",
 "acceptedAnswer": {
 "@type": "Answer",
 "text": "FAQ Schema ist ein strukturiertes Datenformat nach Schema.org,
 das Suchmaschinen hilft, Fragen und Antworten auf einer Webseite
 zu erkennen und als Rich Result darzustellen."
 }
 },
 {
 "@type": "Question",
 "name": "Wie implementiere ich FAQ Schema?",
 "acceptedAnswer": {
 "@type": "Answer",
 "text": "Du fügst einen JSON-LD Script-Block mit dem @type FAQPage
 in den head- oder body-Bereich deiner HTML-Seite ein."
 }
 }
 ]
}
</script>

Wichtig: Das Feld name enthält die Frage, text innerhalb von acceptedAnswer enthält die Antwort. Beide Felder sind Pflichtfelder.

Schritt 4: JSON-LD in den HTML-Code einfügen

Platziere den fertigen <script>-Block entweder im <head>-Bereich oder direkt vor dem schließenden </body>-Tag deiner Seite. Beide Positionen werden von Google akzeptiert.

In WordPress: Gehe zu Appearance → Theme File Editor → header.php und füge den Block vor </head> ein. Alternativ nutze ein Plugin wie RankMath oder Yoast SEO, dort unter SEO → Schema → Custom Schema → FAQPage.

Sauberer als eine Änderung an der header.php ist ein Hook in der functions.php deines Child-Themes. So bleibt das Markup bei Theme-Updates erhalten und erscheint nur auf der gewünschten Seite. json_encode kümmert sich dabei um korrekt escapte Anführungszeichen und Umlaute:

// In functions.php des Child-Themes
function add_faq_schema() {
 if ( is_page( 'faq' ) ) {
 $schema = array(
 '@context' => 'https://schema.org',
 '@type' => 'FAQPage',
 'mainEntity' => array(
 array(
 '@type' => 'Question',
 'name' => 'Was ist FAQ Schema?',
 'acceptedAnswer' => array(
 '@type' => 'Answer',
 'text' => 'FAQ Schema ist ein strukturiertes Datenformat nach Schema.org.'
 )
 )
 )
 );
 echo '<script type="application/ld+json">' . json_encode( $schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES ) . '</script>';
 }
}
add_action( 'wp_head', 'add_faq_schema' );

In Webflow: Gehe zu Page Settings → Custom Code → Before </body> tag und füge den Block ein.

In Next.js und anderen React-Frameworks: Gib den Block serverseitig aus, zum Beispiel über next/head beziehungsweise die Metadata-Funktionen des App Routers, damit er schon im ausgelieferten HTML steht und nicht erst im Browser nachgeladen wird.

In Shopify: Bearbeite das Theme unter Online Store → Themes → Edit Code → theme.liquid und füge den Block vor </head> ein.

Schritt 5: JSON auf Syntaxfehler prüfen

Bevor du den Code live schaltest, prüfe ihn auf JSON-Syntaxfehler. Gehe auf jsonlint.com, füge deinen JSON-Inhalt (ohne den <script>-Tag) ein und klicke auf Validate JSON. Häufige Fehler sind fehlende Kommas zwischen Objekten, nicht geschlossene geschweifte Klammern oder falsch escapte Anführungszeichen. Der Validator zeigt dir die genaue Zeilennummer des Fehlers an.

Schritt 6: Im Google Rich Results Test validieren

Gehe auf search.google.com/test/rich-results. Wähle URL testen und gib die URL deiner Seite ein, oder wähle Code testen und füge deinen vollständigen HTML-Code inklusive Script-Block ein. Klicke auf URL testen. Wenn alles korrekt ist, siehst du unter Erkannte strukturierte Daten den Eintrag FAQPage mit einem grünen Häkchen und der Anzahl der erkannten Fragen.

Schritt 7: Seite in Google Search Console zur Indexierung einreichen

Damit Google die Änderungen schnell aufnimmt, reiche die URL manuell ein. Gehe in der Google Search Console auf URL-Prüfung, gib deine Seiten-URL ein und klicke auf Indexierung beantragen. Google crawlt die Seite in der Regel innerhalb von 24 bis 72 Stunden neu. Danach kannst du unter Verbesserungen → FAQ sehen, ob das Markup erkannt wurde.

Häufige Fehler beim FAQ Schema implementieren

• Fragen nicht sichtbar auf der Seite: Google lehnt FAQ Rich Results ab, wenn die Fragen und Antworten nur im Schema-Code, nicht aber im sichtbaren HTML-Inhalt der Seite stehen. Stelle sicher, dass jede Frage auch als Text auf der Seite erscheint.
• Falscher @type-Wert: Schreibfehler wie faqpage, FAQ oder FaqPage führen dazu, dass Google das Markup nicht erkennt. Der korrekte Wert lautet exakt FAQPage.
• HTML-Tags im text-Feld: Google erlaubt im text-Feld der Antwort nur einfaches HTML wie <a>, <strong> und <br>. Komplexe Tags wie <div> oder <table> können Fehler verursachen.
• Zu viele FAQs auf einer Seite: Google empfiehlt, FAQ Schema nur auf Seiten einzusetzen, die wirklich FAQ-Charakter haben. Seiten mit 20+ Fragen werden seltener als Rich Result ausgespielt. Fokussiere dich auf 3 bis 8 hochrelevante Fragen.
• Generische oder veraltete Fragen: Fragen wie „Was macht euer Unternehmen?" sucht niemand, sie bringen weder in der Suche noch in KI-Antworten etwas. Formuliere Fragen, die deine Kunden wirklich stellen, und halte die Antworten aktuell. Eine veraltete Antwort, die eine KI zitiert, schadet deiner Glaubwürdigkeit mehr als gar keine.
• Doppeltes Schema auf einer Seite: Wenn du sowohl manuell als auch über ein SEO-Plugin FAQ Schema einfügst, entstehen Duplikate. Prüfe im Rich Results Test, ob das Markup doppelt erscheint, und entferne eine der Quellen. Auch mehrere getrennte FAQPage-Blöcke auf derselben Seite sind falsch: Fasse alle Fragen in einem einzigen Block zusammen.

Verifizierung: So testest du die Implementierung

Nutze diese drei Methoden, um sicherzustellen, dass dein FAQ Schema korrekt funktioniert:

1. Google Rich Results Test: Gehe auf search.google.com/test/rich-results, gib deine URL ein und prüfe, ob FAQPage ohne Fehler erkannt wird. Warnungen sind akzeptabel, Fehler müssen behoben werden.
2. Google Search Console, Verbesserungen: Nach dem Crawl erscheint unter Search Console → Verbesserungen → FAQ eine Übersicht aller Seiten mit FAQ-Markup. Hier siehst du Fehler, Warnungen und gültige Einträge.
3. Direkte Google-Suche: Suche nach deinem Ziel-Keyword in Google. Wenn das FAQ Rich Result ausgespielt wird, erscheinen die Fragen direkt unter deinem Suchergebnis als aufklappbare Elemente. Dies kann einige Tage nach der Indexierung dauern.

Tipp: Nutze den Schema.org Validator als zusätzliche Prüfung, er zeigt dir, ob dein Markup der offiziellen Schema.org-Spezifikation entspricht, unabhängig von Googles Interpretation.