Distribution

Comment ajouter le balisage VideoObject à une page de film ?

Ajoutez un VideoObject en JSON-LD sur la page où la vidéo se regarde. Renseignez son titre, l’URL de sa vignette et sa première date de publication, puis l’adresse du fichier ou du lecteur. Testez la page publique avec le test des résultats enrichis de Google.

Sur la page où l’on peut regarder votre vidéo, insérez un bloc JSON-LD de type VideoObject dans le HTML, ou utilisez le champ prévu par votre CMS pour les données structurées. Renseignez au minimum name, thumbnailUrl et uploadDate, puis l’URL du fichier vidéo ou du lecteur quand elle est disponible. Le contenu déclaré doit décrire cette vidéo visible, pas le film entier si vous ne montrez que sa bande-annonce. Testez ensuite l’URL publique avec l’outil Google.

Préparer les valeurs pour la vidéo, puis pour sa page

Un monteur choisit l’image qui servira de vignette.

Dans name, écrivez le titre de la vidéo, par exemple « Les Îles — bande-annonce ». Dans thumbnailUrl, donnez l’adresse complète d’une image stable et accessible. uploadDate correspond à la première publication de cette vidéo, au format ISO 8601 avec le fuseau horaire conseillé ; ne le remplacez pas par la date de révision de la page. La description et la durée sont recommandées, mais distinctes de ces trois champs obligatoires. Dans notre exemple fictif, PT1M38S signifie 1 minute et 38 secondes. Remplacez chaque valeur par celle de votre vidéo. Les exigences VideoObject de Google détaillent ces champs.

Indiquer à quelle vidéo le balisage se rapporte

Exemple JSON-LD : les informations décrivent la bande-annonce et son lecteur, pas une autre page.
Exemple JSON-LD : les informations décrivent la bande-annonce et son lecteur, pas une autre page.

embedUrl désigne le lecteur intégrable, souvent l’adresse du src de votre iframe. contentUrl désigne le fichier vidéo lui-même, par exemple un MP4 public ; ce n’est pas l’adresse de la page qui l’entoure. Google recommande le fichier quand vous pouvez le fournir, sinon le lecteur. Dans le code ci-dessous, /lecteur/les-iles est donc une adresse de lecteur fictive, à remplacer. Ne déclarez ni un lien temporaire expiré ni un master réservé au jury. Si plusieurs vidéos figurent sur la page, vérifiez à quel lecteur chaque objet se rapporte. Le guide de la page de visionnage aide à choisir le contenu principal.

Exemple fictif à adapter aux valeurs réelles de votre vidéo. La durée est ici de 1 min 38 s.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Les Îles — bande-annonce",
  "thumbnailUrl": "https://example.com/images/les-iles.jpg",
  "uploadDate": "2026-10-29T18:30:00+01:00",
  "duration": "PT1M38S",
  "embedUrl": "https://example.com/lecteur/les-iles"
}
</script>

CRÉER UNE CHAÎNE YOUTUBE PROFESSIONNELLE

Construisez votre chaîne et organisez la publication de vos vidéos.

Découvrir la formation

Tester le HTML réellement publié

Le test des résultats enrichis peut analyser l’URL publique de la page qui contient la vidéo.

Ouvrez le test des résultats enrichis sur l’URL publique exacte. Développez l’élément vidéo détecté, vérifiez ses champs et corrigez les erreurs bloquantes. Comparez ensuite titre, durée et vignette avec le lecteur réel.

Si votre CMS injecte déjà ce balisage, corrigez la source existante plutôt que d’ajouter un deuxième objet contradictoire.

Le test indique ce que l’outil reconnaît ; il ne prouve pas que Google a indexé la vidéo ni qu’il affichera un résultat enrichi. Vérifiez ces états séparément dans Search Console. Pour contrôler le lecteur lui-même, suivez notre guide d’intégration YouTube.

Pour aller plus loin.

Cliquez sur une formation pour découvrir son programme en détail.

Apprenez à réaliser vos films.

+40 formations en ligne pour écrire, tourner, monter et diffuser vos films. Des cours illustrés, des exercices et des ressources pour progresser à votre rythme.

Découvrir L’INDUSTRIE