Video Schema for Videos: The Complete 2026 Guide

Video schema is a structured data vocabulary that describes video content embedded on a page. When implemented correctly, it enables rich results that display video thumbnails, duration, upload date, and a direct play button in search snippets. This guide covers the on-page application of Video schema for pages containing embedded video content, distinguishing it from broader structured data strategies covered elsewhere.

Video rich results are among the most engaging SERP features. Google displays a prominent video thumbnail with a play icon, duration badge, and upload date that drives significantly higher click-through rates than text-only snippets. Pages with video schema are also eligible for the video carousel in search results and can appear in Google Video search.

Google's documentation confirms that Video schema is required for video rich results and video carousels. The schema helps Google understand the video's topic, duration, and quality without rendering the page and executing JavaScript players.

The core properties for Video schema include:

• @type: Use VideoObject.
• name: The video title.
• description: A short description of the video content.
• thumbnailUrl: An array of thumbnail image URLs (at least one, 120x90 minimum).
• uploadDate: The ISO 8601 upload date.
• duration: The ISO 8601 duration (e.g., PT5M30S).
• contentUrl: A direct URL to the video file (for non-YouTube hosted videos).
• embedUrl: A URL to the video player embed page.
• interactionStatistic: Optional. User engagement data like view count.

Below is a complete JSON-LD block for a video page. Place it inside a <script type="application/ld+json"> tag.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to Implement Video Schema in 2026",
  "description": "A step-by-step tutorial showing developers how to add VideoObject structured data to their pages.",
  "thumbnailUrl": [
    "https://example.com/videos/video-schema-tutorial-thumb.jpg",
    "https://example.com/videos/video-schema-tutorial-thumb-sm.jpg"
  ],
  "uploadDate": "2026-06-01T10:00:00Z",
  "duration": "PT8M45S",
  "contentUrl": "https://example.com/videos/video-schema-tutorial.mp4",
  "embedUrl": "https://example.com/embed/video-schema-tutorial",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "https://schema.org/WatchAction",
    "userInteractionCount": "12453"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example Media",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.webp"
    }
  }
}

Provide both contentUrl and embedUrl when possible. contentUrl points to the actual video file (MP4, WebM), while embedUrl points to the player page. For YouTube-hosted videos, use only embedUrl and reference the standard YouTube embed URL format.

Use high-quality thumbnails. Google's documentation recommends thumbnails at least 120px wide, but 1280x720 provides the best SERP display. Include multiple thumbnail sizes for different display contexts.

Validate every video page's schema with Google's Rich Results Test. Confirm that uploadDate is a valid ISO 8601 datetime with timezone. Check that duration uses the format PT + hours H + minutes M + seconds S. Ensure the video file is accessible at the contentUrl or the embed player is functional at the embedUrl. Run a site-wide audit to identify pages with embedded videos that are missing Video schema markup.

1. Google Search Central. "Video structured data." https://developers.google.com/search/docs/appearance/structured-data/video
2. Schema.org. "VideoObject type definition." https://schema.org/VideoObject
3. Google Developers. "Rich results test." https://search.google.com/test/rich-results