Voraussetzungen
Bevor du mit der Implementierung beginnst, stelle sicher, dass folgende Punkte erfüllt sind:
- Zugriff auf den HTML-Quellcode deiner Seite oder Zugang zu einem CMS wie WordPress, wo du eigene Skripte einfügen kannst.
- Eine Seite mit klaren Schritten: HowTo Schema eignet sich nur für Inhalte, die eine Aufgabe in definierten Schritten beschreiben (z. B. „Wie installiere ich ein Plugin?").
- Ein Google-Konto für den Rich Results Test und die Search Console.
- Grundlegendes Verständnis von HTML: Du musst wissen, wo du ein
<script>-Tag im<head>oder vor</body>einfügst. - Kein Duplicate Content: Die Schritte im Schema müssen mit dem sichtbaren Seiteninhalt übereinstimmen — Google prüft das.
Schritt-für-Schritt Anleitung
Schritt 1: Grundstruktur des HowTo Schemas verstehen
HowTo Schema wird als JSON-LD implementiert. Das bedeutet: Du fügst ein <script type='application/ld+json'>-Tag in deine Seite ein. Die Mindestfelder sind @context, @type, name und step. Jeder Schritt ist ein HowToStep-Objekt mit name und text.
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "Wie du HowTo Schema implementierst",
"step": [
{
"@type": "HowToStep",
"name": "Schritt 1",
"text": "Beschreibung des Schritts."
}
]
}Schritt 2: Vollständiges JSON-LD Markup erstellen
Erstelle das vollständige Markup mit allen relevanten Feldern. Empfohlen sind zusätzlich description, totalTime (im ISO-8601-Format, z. B. PT30M für 30 Minuten) und image. Hier ein vollständiges Beispiel:
<script type='application/ld+json'>
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "Wie du HowTo Schema implementierst",
"description": "Eine Schritt-fuer-Schritt-Anleitung zur Implementierung von HowTo Schema mit JSON-LD.",
"totalTime": "PT20M",
"step": [
{
"@type": "HowToStep",
"position": "1",
"name": "JSON-LD Grundstruktur erstellen",
"text": "Erstelle ein script-Tag mit type application/ld+json und fuege die HowTo-Basisstruktur ein."
},
{
"@type": "HowToStep",
"position": "2",
"name": "Schritte als HowToStep hinzufuegen",
"text": "Fuelle das step-Array mit HowToStep-Objekten. Jeder Schritt benoetigt name und text."
}
]
}
</script>Schritt 3: Markup in die Seite einfügen
Füge das fertige <script>-Tag direkt vor dem schließenden </head>-Tag oder vor </body> ein. In WordPress gehst du zu Darstellung → Theme-Editor → header.php und fügst das Skript vor </head> ein. Alternativ nutze ein Plugin wie Insert Headers and Footers: Gehe zu Einstellungen → Insert Headers and Footers, füge das Skript in das Feld „Scripts in Header" ein und klicke auf Speichern. Bei statischen HTML-Seiten öffnest du die jeweilige Datei im Editor und fügst das Tag manuell ein.
Schritt 4: Schritte mit dem sichtbaren Inhalt abgleichen
Google vergleicht das Schema mit dem tatsächlich sichtbaren Seiteninhalt. Stelle sicher, dass jeder HowToStep im Schema auch als sichtbarer Text auf der Seite erscheint. Öffne deine Seite im Browser und vergleiche jeden Schritt im JSON mit dem entsprechenden Abschnitt im Artikel. Wenn ein Schritt im Schema beschreibt „Klicke auf Einstellungen → SEO", muss genau dieser Text oder eine sehr ähnliche Formulierung auch im sichtbaren Seitentext stehen. Abweichungen führen dazu, dass Google das Rich Result nicht ausspielt.
Schritt 5: Optionale Felder für bessere Rich Results ergänzen
Für maximale Darstellung in den Suchergebnissen kannst du folgende optionale Felder ergänzen:
image: Ein Bild-URL für den gesamten HowTo oder pro Schritt (HowToStep).supply: Materialien oder Werkzeuge alsHowToSupply-Objekte.tool: Benötigte Tools alsHowToTool-Objekte.estimatedCost: Kosten alsMonetaryAmount-Objekt.
"supply": [
{ "@type": "HowToSupply", "name": "Texteditor" },
{ "@type": "HowToSupply", "name": "Google Search Console Zugang" }
],
"tool": [
{ "@type": "HowToTool", "name": "Rich Results Test" }
]Schritt 6: Markup mit dem Rich Results Test prüfen
Gehe auf search.google.com/test/rich-results. Gib entweder die URL deiner Seite ein (wenn sie bereits live ist) oder füge den HTML-Code direkt in das Textfeld ein. Klicke auf URL testen bzw. Code testen. Das Tool zeigt dir, ob HowTo Schema erkannt wurde und ob Fehler oder Warnungen vorliegen. Ein grünes Häkchen bei „HowTo" bedeutet: Das Markup ist valide und grundsätzlich für Rich Results geeignet.
Schritt 7: Schema.org Validator als zweite Prüfung nutzen
Rufe validator.schema.org auf und füge entweder deine URL oder den JSON-LD-Code ein. Klicke auf Run Test. Der Validator zeigt dir alle erkannten Eigenschaften und warnt bei fehlenden empfohlenen Feldern. Achte besonders auf Warnungen zu image — Google empfiehlt Bilder für eine vollständige Rich-Result-Darstellung auf Mobilgeräten. Behebe alle als „Error" markierten Punkte, bevor du die Seite indexieren lässt.
Schritt 8: Seite in der Google Search Console zur Indexierung einreichen
Öffne die Google Search Console und wähle deine Property aus. Gehe zu URL-Prüfung, gib die URL der Seite ein und drücke Enter. Klicke auf Indexierung beantragen. Google crawlt die Seite neu und erkennt das frisch eingefügte Schema. Dieser Schritt beschleunigt die Aufnahme des Rich Results erheblich — ohne ihn kann es Wochen dauern, bis Google die Änderung bemerkt.
Häufige Fehler beim HowTo Schema implementieren
1. Schema stimmt nicht mit dem sichtbaren Inhalt überein
Der häufigste Fehler: Das JSON-LD beschreibt Schritte, die auf der Seite gar nicht oder anders formuliert sind. Google gleicht Schema und sichtbaren Inhalt ab. Lösung: Schreibe die text-Werte im Schema immer nach dem sichtbaren Seitentext — nicht umgekehrt.
2. Fehlende Pflichtfelder
name auf HowTo-Ebene und text in jedem HowToStep sind Pflichtfelder. Fehlen sie, wird das Markup im Rich Results Test als fehlerhaft markiert. Prüfe nach jeder Änderung erneut mit dem Rich Results Test.
3. Falsches ISO-8601-Format bei totalTime
Viele schreiben "totalTime": "30 Minuten" — das ist falsch. Korrekt ist das ISO-8601-Format: "totalTime": "PT30M" (30 Minuten) oder "PT1H30M" (1 Stunde 30 Minuten). Falsche Formate führen zu Warnungen im Validator.
4. HowTo Schema auf ungeeigneten Seiten
HowTo Schema darf nur auf Seiten eingesetzt werden, die tatsächlich eine Aufgabe in Schritten erklären. Auf Produktseiten, Kategorieseiten oder reinen Blogartikeln ohne Schritt-Struktur ist es laut Google-Richtlinien nicht erlaubt und kann zu manuellen Maßnahmen führen.
5. Doppeltes Schema durch Plugins
Wenn du gleichzeitig ein SEO-Plugin (z. B. Yoast, RankMath) und manuelles JSON-LD verwendest, kann es zu doppeltem HowTo Schema kommen. Prüfe im Rich Results Test, ob das Markup doppelt ausgespielt wird, und deaktiviere die Schema-Funktion im Plugin für diese Seite.
Verifizierung: So testest du, ob es funktioniert
Nach der Implementierung gibt es drei Wege zur Verifikation:
- Rich Results Test (sofort): Gehe zu search.google.com/test/rich-results, gib deine URL ein. Ein grünes Ergebnis mit „HowTo" bestätigt valides Markup.
- Search Console → Verbesserungen (nach 1–2 Wochen): In der Google Search Console erscheint unter Verbesserungen ein Eintrag „Anleitungen (HowTo)", sobald Google die Seite gecrawlt hat. Dort siehst du Fehler, Warnungen und gültige Elemente.
- Google-Suche (nach Indexierung): Suche auf einem Mobilgerät nach deinem Ziel-Keyword. HowTo Rich Results werden primär auf Mobilgeräten ausgespielt. Erscheinen die Schritte direkt in den Suchergebnissen, ist die Implementierung erfolgreich.
Tipp: Nutze die Chrome-Erweiterung Schema Markup Validator oder öffne die Entwicklertools (F12 → Quellcode), suche nach application/ld+json und prüfe, ob dein Markup korrekt gerendert wird — besonders wichtig bei JavaScript-gerenderten Seiten.