Schéma VideoObject

Le schéma VideoObject est une donnée structurée qui décrit une vidéo visible et la page qui la contient, afin que Google comprenne mieux le contenu vidéo éligible dans la recherche.

Ce qu’est le schéma VideoObject

VideoObject est un type de Schema.org conçu pour décrire le contenu vidéo d’une page. Il s’intègre au HTML sous forme de JSON-LD et aide Google à comprendre le contenu de la vidéo sans avoir à la lire.

Le schéma présente les principales entrées, les contrôles et le chemin de décision du schéma VideoObject.

Sans balisage VideoObject, Google peut tout de même découvrir et indexer les vidéos. Avec ce balisage, les chances d’apparaître dans les résultats enrichis (carrousels vidéo, extraits améliorés) sont nettement plus élevées.

Pour les vidéos YouTube intégrées via iframe, Google reçoit les données directement de YouTube. Le schéma VideoObject reste utile pour enrichir le contexte de la page.

Champs VideoObject obligatoires

name
Le titre de la vidéo. Il doit correspondre au titre visible sur la page et dans le lecteur vidéo.
description
Description textuelle du contenu vidéo. Une phrase au minimum ; deux à cinq phrases sont recommandées.
thumbnailUrl
URL de l’image de vignette. Minimum 160×90 px. Elle doit être accessible à Googlebot.
uploadDate
Date de publication au format ISO 8601 (par exemple 2026-05-26T10:00:00+03:00).
contentUrl
URL directe du fichier vidéo. Obligatoire pour les vidéos hébergées sur votre serveur. Pour YouTube, utilisez embedUrl.
embedUrl
URL du lecteur intégré (attribut src de l’iframe). Pour YouTube : https://www.youtube.com/embed/VIDEO_ID.
duration
Durée au format ISO 8601 : PT4M30S = 4 minutes 30 secondes. Elle est affichée dans l’extrait.
expires
Date à laquelle le contenu vidéo expire. Après cette date, Google n’affiche plus la vidéo dans les résultats enrichis.
hasPart
Extraits de la vidéo avec horodatage (schéma Clip). Ils permettent d’afficher les moments clés (Key Moments) dans les résultats de recherche.
interactionStatistic
Nombre de vues. Type d’interaction : UserInteraction: WatchAction.

Exemple de balisage VideoObject

Le balisage s’ajoute à la balise <head> ou <body> de la page, dans une balise <script type="application/ld+json">. Exemple minimal valide : { "@context": "https://schema.org", "@type": "VideoObject", "name": "Video Title", "description": "Video description", "thumbnailUrl": "https://example.com/thumb.jpg", "uploadDate": "2026-05-26" }

Résultats enrichis disponibles avec VideoObject

  • Carrousel vidéo : un groupe de résultats vidéo dans la SERP pour une requête thématique
  • Extrait amélioré : vignette et durée affichées dans un résultat standard
  • Key Moments : horodatages permettant de naviguer entre les sections de la vidéo (nécessite le schéma Clip dans hasPart)
  • Badge Live : étiquette LIVE pour les diffusions en direct (champ BroadcastEvent)

FAQ

Le schéma VideoObject est-il nécessaire pour chaque vidéo d’un site ?
Recommandé pour toutes les vidéos que vous souhaitez mettre en avant dans la recherche. Si une vidéo n’est qu’un élément secondaire de la page, sans valeur de recherche propre, le balisage est facultatif.
Comment valider le balisage VideoObject ?
Utilisez le test des résultats enrichis de Google (search.google.com/test/rich-results) : collez l’URL de la page ou son code. L’outil affiche les champs détectés et les erreurs.
Pourquoi la vidéo n’apparaît-elle pas dans les résultats enrichis malgré un balisage correct ?
Le balisage est nécessaire mais pas suffisant. Google décide seul d’afficher ou non des résultats enrichis. Vérifiez que la vignette est accessible à Googlebot, que la page vidéo est indexable et que le contenu est à jour.
Peut-on ajouter le schéma VideoObject pour les vidéos YouTube intégrées ?
Oui, et c’est recommandé. Bien que Google reçoive directement les données de la vidéo YouTube, le schéma VideoObject sur votre page l’aide à comprendre le contexte de la page et à relier la vidéo à son sujet.