Video Structured Data: Complete Implementation Guide

Why Use VideoObject Schema?

• Display a prominent video thumbnail with duration badge in search results, dramatically increasing click-through rates
• Enable Key Moments (video chapters) in search results, allowing users to jump directly to specific sections of your video
• Appear in Google's Video tab search results and video carousels on the main search page
• Help Google understand your video content for better matching against relevant search queries
• Increase engagement by providing users with a clear preview of what the video covers before they click

Required Properties

These properties are required by Google for VideoObject structured data to be eligible for rich results.

Recommended Properties

Adding these properties improves your chances of appearing in rich results and provides more context to search engines.

JSON-LD Example

Here is a complete VideoObject structured data example you can use as a starting point. Or use our VideoObject generator to create one automatically.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to Build a Garden Raised Bed — Step-by-Step Guide",
  "description": "Learn how to build a raised garden bed from scratch using timber sleepers. This guide covers materials, tools, soil preparation, and planting tips for beginners.",
  "thumbnailUrl": "https://example.com/images/raised-bed-thumb.jpg",
  "uploadDate": "2026-02-18",
  "duration": "PT12M45S",
  "contentUrl": "https://example.com/videos/raised-bed-guide.mp4",
  "embedUrl": "https://example.com/embed/raised-bed-guide",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": {
      "@type": "WatchAction"
    },
    "userInteractionCount": 48230
  },
  "hasPart": [
    {
      "@type": "Clip",
      "name": "Materials and tools needed",
      "startOffset": 0,
      "endOffset": 95,
      "url": "https://example.com/videos/raised-bed-guide?t=0"
    },
    {
      "@type": "Clip",
      "name": "Measuring and cutting the sleepers",
      "startOffset": 95,
      "endOffset": 280,
      "url": "https://example.com/videos/raised-bed-guide?t=95"
    },
    {
      "@type": "Clip",
      "name": "Assembling the frame",
      "startOffset": 280,
      "endOffset": 490,
      "url": "https://example.com/videos/raised-bed-guide?t=280"
    },
    {
      "@type": "Clip",
      "name": "Filling with soil and compost",
      "startOffset": 490,
      "endOffset": 620,
      "url": "https://example.com/videos/raised-bed-guide?t=490"
    },
    {
      "@type": "Clip",
      "name": "Planting tips for beginners",
      "startOffset": 620,
      "endOffset": 765,
      "url": "https://example.com/videos/raised-bed-guide?t=620"
    }
  ],
  "author": {
    "@type": "Person",
    "name": "Claire Gardener",
    "url": "https://example.com/authors/claire-gardener"
  }
}
</script>

How to Implement VideoObject Schema

1. 1Identify all pages on your site that contain video content and ensure each video is the primary or prominent content on the page — Google may not generate rich results for incidental videos.
2. 2Add a JSON-LD script block to each video page using the VideoObject type with all required properties: name, thumbnailUrl, uploadDate, and either contentUrl or embedUrl.
3. 3Include the duration property in ISO 8601 format to enable the duration badge on thumbnails in search results.
4. 4For longer videos, add Key Moments using the hasPart property with an array of Clip objects, each specifying a name, startOffset (in seconds), and a URL with a timestamp parameter.
5. 5Validate your structured data using Google's Rich Results Test and resolve any errors, paying particular attention to thumbnail accessibility and video URL validity.
6. 6Monitor the Video enhancement report in Google Search Console to track indexing status, rich result impressions, and any issues that need attention.

Common Mistakes to Avoid

• Using a thumbnailUrl that is blocked by robots.txt or requires authentication — the thumbnail must be freely crawlable for Google to display it in rich results.
• Omitting the duration property, which means your video thumbnails will lack the duration badge that users rely on when scanning search results.
• Providing an embedUrl that points to a page rather than an embeddable player — the URL must load a functional video player when accessed directly.
• Adding VideoObject markup to pages where the video is not the main content, such as a blog post with an incidental embedded clip — Google prioritises pages where the video is prominent.
• Formatting the duration incorrectly — it must follow ISO 8601 format (e.g., PT1H30M for 1 hour 30 minutes, PT5M45S for 5 minutes 45 seconds), not a plain time string.

Testing & Validation

Before deploying your VideoObject structured data, validate it using these tools:

1. 1Google Rich Results Test — Paste your page URL or code snippet to check if your structured data is eligible for rich results.
2. 2Schema Markup Validator — Validates your JSON-LD syntax against the schema.org specification.
3. 3Google Search Console — After deployment, monitor the Enhancements report for any errors or warnings.

Frequently Asked Questions