Video Schema Markup in WordPress einfügen – Anleitung mit JSON-LD & Plugin-Beispielen (2025)

Warum Video Schema Markup wichtig ist

Wenn Du Videos in Deine Website einbindest, versteht Google nicht automatisch, worum es im Video geht.
Mit dem richtigen Schema Markup (strukturierten Daten) sagst Du Google explizit:
„Das hier ist ein Video – mit Titel, Beschreibung, Thumbnail und Veröffentlichungsdatum.“

Vorteile:

• Deine Videos können als Rich Snippets in der Google-Suche erscheinen
• Du hast Chancen auf das Video-Karussell oder Discover-Integrationen
• Deine CTR (Klickrate) steigt, weil Nutzer schon in der Vorschau sehen, was sie erwartet

📊 SEO-Fakt: Korrekt eingebundenes Video-Schema kann Deine Seiten für Video-Funktionen und Rich Results in der Google Suche qualifizieren. Google weist aber darauf hin, dass die Anzeige solcher Ergebnisse nicht garantiert ist.

Video Markup, VideoObject und Schema.org: Was ist der Unterschied?

Die Begriffe Video Markup, VideoObject und Schema.org werden oft durcheinandergeworfen – gemeint ist aber nicht immer dasselbe.

• Schema.org ist das Vokabular für strukturierte Daten. Dort sind die Typen und Eigenschaften definiert.
• VideoObject ist der konkrete Schema-Typ für Videos. Damit beschreibst Du Titel, Beschreibung, Thumbnail, Upload-Datum und weitere Eigenschaften Deines Videos.
• Video Markup oder Video Schema ist die praktische Umsetzung auf Deiner Seite – also der Code, mit dem Du diese Informationen für Google auszeichnest, meist als JSON-LD.

Kurz gesagt: Schema.org liefert die Sprache, VideoObject ist der passende Typ für Videos – und Video Markup ist das, was Du daraus konkret in WordPress einbaust.

Das VideoObject-Schema verstehen

Das Schema für Videos basiert auf dem Typ VideoObject aus dem Schema.org-Vokabular.
Es beschreibt die wichtigsten Eigenschaften Deines Videos.

Pflichtfelder

Feld	Beschreibung
name	Der Videotitel (am besten inkl. Hauptkeyword)
description	Kurze Beschreibung des Inhalts
thumbnailUrl	URL zum Thumbnail (empfohlen: 16:9 Format)
uploadDate	Veröffentlichungsdatum im Format YYYY-MM-DD
contentUrl oder embedUrl	Eines von beiden ist Pflicht: embedUrl (Link zum Player, z. B. von YouTube) bei Einbettungen von Drittanbietern. contentUrl (direkter Link zur MP4-Datei) bei eigengehosteten Videos.

embedUrl oder contentUrl: Wann Du welche Angabe verwenden solltest

Gerade bei Video Schema gibt es hier oft Verwirrung: embedUrl und contentUrl meinen nicht dasselbe – und je nach Hosting-Setup ist die richtige Angabe entscheidend.

• YouTube oder Vimeo eingebettet: Dann ist meist embedUrl die richtige Angabe, also der Link zum eingebetteten Player.
• Video selbst gehostet: Dann brauchst Du meist contentUrl, also die direkte URL zur Videodatei, zum Beispiel zur MP4- oder WebM-Datei.
• Mischfälle sauber prüfen: Wenn Du ein Video extern einbettest, aber zusätzlich lokal hostest, solltest Du besonders auf Konsistenz bei URL, Thumbnail und Metadaten achten.

Faustregel: embedUrl beschreibt den Player, contentUrl die eigentliche Videodatei. Welche Variante für Dich passt, hängt also direkt davon ab, ob Du Dein Video einbettest oder selbst hostest.

Empfohlene Zusatzfelder

Feld	Beschreibung
duration	Laufzeit, z. B. PT5M30S für 5 Minuten 30 Sekunden
interactionCount	Aufrufe oder Views (optional)
publisher	Herausgeber, z. B. Dein Blog oder YouTube-Kanal

Beispiel eines vollständigen VideoObject-Schemas

{
 "@context": "https://schema.org",
 "@type": "VideoObject",
 "name": "Video-SEO für WordPress 2025 – So optimierst Du Deine Videos",
 "description": "Lerne, wie Du Videos suchmaschinenfreundlich einbindest und für Rich Snippets optimierst.",
 "thumbnailUrl": "https://derwebfuchs.de/uploads/video-seo-thumbnail.jpg",
 "uploadDate": "2025-03-01",
 "duration": "PT5M30S",
 "embedUrl": "https://www.youtube.com/embed/xyz123",
 "publisher": {
   "@type": "Organization",
   "name": "Der Webfuchs",
   "logo": {
     "@type": "ImageObject",
     "url": "https://derwebfuchs.de/uploads/logo-derwebfuchs.png"
   }
 }
}

Variante 1: Automatisch per Plugin (Yoast, RankMath & Co.)

Für die meisten Nutzer ist das die einfachste Lösung:
SEO-Plugins übernehmen das Markup automatisch, sobald ein Video eingebunden wird.

RankMath

1. Öffne den Beitrag, in dem Dein Video enthalten ist.
2. Scrolle zum RankMath-Meta-Panel und aktiviere unter „Erweitert“ → Video Schema aktivieren.
3. RankMath erkennt automatisch das Video (z. B. YouTube-Einbettung) und erstellt das JSON-LD-Markup.
4. Optional kannst Du Felder wie „Beschreibung“ oder „Dauer“ manuell ergänzen.

Prüfung: Nach dem Speichern kannst Du die Seite über den Rich Results Test validieren.

Yoast SEO

1. Aktiviere das Modul „Video SEO“ (Premium-Add-on erforderlich).
2. Füge Dein Video ein (z. B. YouTube oder MP4-URL).
3. Yoast erstellt automatisch das Schema mit allen Pflichtfeldern.

Hinweis: Wenn Du viele Videos nutzt, lohnt sich das Add-on langfristig, da es auch XML-Video-Sitemaps generiert.

Variante 2: Video Schema manuell einfügen (für Fortgeschrittene)

Wenn Du volle Kontrolle möchtest oder kein Plugin einsetzen willst, kannst Du das Schema auch manuell integrieren.

Schritt-für-Schritt

1. Kopiere Dein JSON-LD-Markup (siehe Beispiel oben).
2. Öffne die functions.php Deines Child-Themes oder nutze ein Snippet-Plugin (z. B. Code Snippets).
3. Füge folgenden Code ein:

function dwf_add_video_schema() {
?>
<script type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "VideoObject",
 "name": "Video Schema Markup Tutorial für WordPress",
 "description": "Anleitung zum Einfügen von VideoObject Schema in WordPress – manuell per Code.",
 "thumbnailUrl": "https://deine-seite.de/uploads/video-schema-thumbnail.jpg",
 "uploadDate": "2025-04-15",
 "duration": "PT3M45S",
 "embedUrl": "https://www.youtube.com/embed/abc987"
}
</script>
<?php
}
add_action('wp_head', 'dwf_add_video_schema');

4. Speichern, Cache leeren, Seite neu laden.
5. Prüfe Dein Markup mit dem Google Rich Results Test.

So prüfst Du, ob Google Dein Video-Schema wirklich erkennt

Nach dem Einbau kommt der wichtigste Kontrollschritt: Erkennt Google Dein VideoObject wirklich? Genau das solltest Du nicht nur annehmen, sondern immer testen.

1. Öffne den Rich Results Test von Google und prüfe die URL Deiner Seite.
2. Achte darauf, ob VideoObject erkannt wird und ob Pflichtfelder korrekt übernommen wurden.
3. Wenn es Fehler oder Warnungen gibt, prüfe zuerst name, description, thumbnailUrl, uploadDate und embedUrl bzw. contentUrl.
4. Kontrolliere später zusätzlich in der Search Console, ob Dein Video im Video Indexing Report auftaucht und korrekt verarbeitet wird.

Wichtig: Ein korrekt eingebautes Schema heißt noch nicht automatisch, dass sofort ein Rich Snippet erscheint. Aber ohne saubere Prüfung tappst Du schnell im Dunkeln.

Häufige Fehler beim Video Schema

Fehler	Ursache	Lösung
❌ Kein thumbnailUrl angegeben	Google kann das Video nicht rendern	Immer ein 16:9-Thumbnail angeben
❌ Falsches Datumsformat	Nicht ISO-konform (YYYY-MM-DD)	Prüfen & korrigieren
⚠️ Fehlende Dauer (duration)	Kein Pflichtfeld, aber empfehlenswert	Format PT1H2M3S beachten
❌ Doppelte Schema-Ausgabe	Plugin + manuelles Snippet aktiv	Nur eine Variante verwenden

Schema kombinieren: Videos + Artikel

Wenn Du einen Artikel veröffentlichst, der ein eingebettetes Video enthält, ist es Best Practice, das VideoObject-Schema mit dem Article-Schema zu verknüpfen. Dadurch weiß Google: „Das ist ein Artikel, dessen Hauptinhalt (oder ein wesentlicher Bestandteil) ein Video ist.“ Die gängige Methode ist die Einbettung des VideoObjects innerhalb des Article-Schemas, wie im Beispiel über das Feld mainEntity gezeigt:

{
 "@context": "https://schema.org",
 "@type": "Article",
 "headline": "Video-SEO für WordPress 2025",
 "author": { "@type": "Person", "name": "Der Webfuchs" },
 "mainEntity": {
   "@type": "VideoObject",
   "name": "Video-SEO Schritt-für-Schritt erklärt",
   "uploadDate": "2025-03-01",
   "thumbnailUrl": "https://derwebfuchs.de/uploads/video-thumbnail.jpg",
   "embedUrl": "https://www.youtube.com/embed/xyz123"
 }
}

Fazit: Mehr Sichtbarkeit durch sauberes Schema

Ein korrekt eingebundenes Video Schema Markup hilft Google, Deine Videos besser zu verstehen und kann die Sichtbarkeit in passenden Suchdarstellungen verbessern.

Egal ob automatisch per Plugin oder manuell im Code:
Mit sauberem Markup kannst Du CTR, Reichweite und Nutzervertrauen deutlich steigern.

🔗 Lies auch:
👉 Video-SEO für WordPress 2025 – Der umfassende Leitfaden
(Der zentrale Einstieg in alle Themen rund um Video-SEO in WordPress.)
👉 Video-Content-SEO für WordPress 2025 – Inhalte optimieren für maximale Sichtbarkeit
👉 Technische Video-SEO in WordPress – Ladezeiten, Indexierung & Core Web Vitals
👉 Videos in WordPress einbetten (2025) – SEO-freundlich & DSGVO-konform
👉 Video-Hosting für WordPress 2025 – YouTube, Vimeo oder lokal?