Video Schema Generator
Create structured data for YouTube, Vimeo, and self-hosted videos. Display video thumbnails, duration, upload dates, and descriptions directly in Google Search results.
Video schema helps your videos appear in Google Search with thumbnails, duration badges, and upload dates. Works for YouTube embeds, hosted MP4 files, and live streams. Required fields marked with *. Learn more about Video markup →
Required for Rich Results: Name, description, thumbnailUrl, and uploadDate are mandatory. Use ISO 8601 format for duration (e.g., PT2H30M15S). Include both contentUrl and embedUrl when available.
How to Add Video Schema
Get video thumbnails, duration badges, and rich snippets in Google Search results to increase click-through rates and visibility.
Where to Place the Code
Add the JSON-LD code to the <head> section of pages containing videos. Each video should have its own VideoObject schema. For pages with multiple videos, create separate schema objects for each.
- Video detail pages with single embedded video
- Blog posts featuring video content
- Course lesson pages with instructional videos
- Product pages with demo/explainer videos
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Video Title",
"description": "Brief description...",
"thumbnailUrl": "https://example.com/thumb.jpg",
"uploadDate": "2024-01-15",
"duration": "PT15M30S"
}
</script>
Validation Checklist
Required Fields Complete
Name, description, thumbnailUrl, and uploadDate are mandatory
Valid Thumbnail
Minimum 160x90px, accessible without login or restrictions
ISO 8601 Duration
Format: PT2H30M15S (2 hours, 30 min, 15 sec)
Test with Rich Results
Validate markup before publishing to ensure eligibility
Supported Video Platforms
Video schema works with any video hosting solution. Google can extract metadata from YouTube automatically, but adding schema ensures control over what's displayed and adds extra context.
YouTube
Use embed URL and thumbnail from ytimg.com
Vimeo
Player embed URL and vimeocdn thumbnails
Wistia
Embed.ly integration with custom thumbnails
Self-Hosted
MP4 files with direct content URLs
Thumbnail Requirements
Best Practices for Video Schema
Maximize your video visibility with these proven strategies. Properly implemented video schema can dramatically increase organic traffic and engagement.
🎯 Descriptive Titles
Use clear, keyword-rich titles under 100 characters. Include what the video teaches or demonstrates.
📝 Detailed Descriptions
Write 200+ character descriptions that accurately summarize video content. Include timestamps for key sections.
📊 Add Interaction Stats
Include view counts and engagement metrics. Higher numbers increase credibility and click-through rates.
Important: Thumbnail URLs must be accessible to Googlebot without authentication. Avoid URLs that require cookies, session tokens, or IP restrictions. Test by accessing the URL in an incognito window.