Toronto SEO
All schema types
Media
schema.org spec

VideoObject

A video file or stream embedded on a page.

What it is

VideoObject powers video rich results, key moments (chapters), and video carousels in SERP. The contentUrl OR embedUrl is required; uploadDate is critical for freshness scoring.

Required properties
  • name
  • thumbnailUrl
  • uploadDate
  • contentUrl OR embedUrl
Recommended properties
  • description
  • duration
  • expires
  • hasPart (Clip for chapters)
  • transcript
  • interactionStatistic
JSON-LD example
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How AI Is Changing SEO",
  "description": "A 5-minute primer on AEO and GEO.",
  "thumbnailUrl": "https://example.com/thumb.jpg",
  "uploadDate": "2026-04-01",
  "duration": "PT5M30S",
  "contentUrl": "https://example.com/video.mp4",
  "embedUrl": "https://www.youtube.com/embed/abc123"
}
</script>
Google rich result support

Video rich result, key moments, video carousel, LIVE badge for live streams.

When to use it
  • YouTube embeds
  • Self-hosted videos
  • Live streams
  • Video tutorials