Video Schema Markup Generator
VideoObject schema markup enhances how your videos appear across Google Search, Discover, and Video results. It helps search engines understand the content, context, and purpose of your videos — improving discoverability and engagement. When properly implemented, it enables rich video previews with thumbnails, increases click-through rates, and unlocks features like key moments.
Try an example
Fields
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject"
}
</script>Video Schema Markup FAQ
VideoObject schema markup is a type of structured data defined by Schema.org that provides search engines with key details about a video - including its title, description, thumbnail, duration, upload date, and content URL.
When implemented, Google can display your video with a thumbnail preview, duration tag, and play button directly in search results, helping users discover and engage with your video content.
VideoObject schema offers powerful SEO and engagement benefits including making your videos eligible for video rich results in Google which include thumbnails, duration and preview which improves click-through rates.
If you publish tutorials, webinars, explainers, or product demos, adding VideoObject schema can significantly increase your visibility and reach.
The key properties to include:
- Video title
- Description of the video
- URL for a thumbnail image
- Date uploaded (ISO format)
Optionally you can include:
- URL to the video file (MP4 etc.)
- URL to the embedded player
- Organization or channel that is publishing
- Transcript / captions
- Likes or view count
VideoObject schema helps search engines understand and feature your video content more effectively, leading to:
- Rich video snippets with thumbnails, durations, and previews.
- Greater visibility in Google Search, Discover, and Video tabs.
- Higher CTR due to visual differentiation in SERPs.
- Enhanced indexing for video-related keywords.
- Eligibility for key moments and video seek features (timestamp-based highlights).
VideoObject schema bridges the gap between your visual content and search engines - boosting discoverability and engagement.
- Invalid or missing thumbnail: The thumbnail must be at least 1200px wide and publicly accessible via HTTPS.
- Mismatch between schema and visible content: The video described in the schema must actually appear on the page.
- Incorrect date format: Use ISO format:
YYYY-MM-DD. - Duration not in ISO 8601 format: Example: 3 minutes, 45 seconds =
PT3M45S. - Using schema for external content only: You must embed or host the video on your own page; linking to YouTube alone isn't enough.
- No structured publisher info: Include publisher with a logo for better branding and eligibility.
- Multiple videos on one page without clear markup separation: Add a distinct VideoObject for each embedded video.
Yes - as long as the video is embedded on your website.
Use the YouTube embedUrl (e.g., https://www.youtube.com/embed/VIDEO_ID) and provide your own page's contentUrl to connect it properly.
Yes, but each video must have its own complete VideoObject block.
Avoid mixing properties between videos.
Yes. Use the hasPart property to define time-stamped sections within your video:
"hasPart": [{
"@type": "Clip",
"name": "Adding JSON-LD",
"startOffset": 45,
"endOffset": 120,
"url": "https://example.com/video#t=45"
}]This helps your video appear with chapter-style highlights in Google Search.
Not necessarily.
You can embed from YouTube, Vimeo, or other platforms - just ensure the video is playable and visible on the same page as your markup.
interactionStatistic for view or like metrics improves context and trust.Not automatically.
Valid schema makes your video eligible, but Google chooses which to display based on relevance, quality, and accessibility.
Yes.
It's common to include a video alongside Article, Product, or HowTo schema.
Just ensure each schema type describes its respective content clearly.
Additional Resources
Official documentation and guides to help you get the most out of your schema markup.
Use our other schema markup generators
Video rich results without the markup hassle
Schema Pilot detects video content on your pages and generates VideoObject markup with thumbnails, duration, and key moments automatically.