Video Schema Markup: Enabling Rich Results for Your Video Content

Video schema markup tells search engines exactly what your video contains enabling rich results like video carousels key moments and live badges. Proper implementation dramatically increases video visibility in search results and improves click-through rates.

Required VideoObject Properties

Google requires these properties for video rich results: name for the video title, description for a description of the video, thumbnailUrl for the URL of the video thumbnail image, and uploadDate for the date the video was published in ISO 8601 format. Without all required properties your video will not be eligible for rich results.

Recommended Properties

Add these properties for better results: duration in ISO 8601 format like PT2M30S for 2 minutes 30 seconds, contentUrl for the actual video file URL, embedUrl for the URL of the video player, expires if the video will be unavailable after a certain date, and interactionStatistic for view counts and engagement metrics.

Advanced Schema Types

Clip Markup for Key Moments

Clip schema allows you to define specific segments within your video that appear as key moments in Google search results. Each clip requires a name, startOffset in seconds, and endOffset in seconds. This is particularly valuable for tutorial and how-to videos where users want to jump to specific instructions.

SeekToAction Markup

An alternative to Clip markup that allows Google to automatically identify key moments based on the video structure. Requires only the seekToAction property pointing to the URL structure your site uses for timestamp-based navigation. Simpler to implement but less precise than Clip markup.

Live Video Markup

For live streaming content add BroadcastEvent schema with isLiveBroadcast set to true. Include startDate and optionally endDate for scheduled live events. This enables a LIVE badge in Google search results for your live streams.

Learning Video Markup

For educational content LearningVideo schema provides additional context about the educational level and learning objectives. Useful for online courses and educational platforms seeking enhanced visibility in Google learning-rich results.

Implementation Examples

Implement VideoObject schema using JSON-LD in the head of your video pages. The schema must accurately reflect the visible content on the page. The thumbnail image must be accessible to Googlebot and at least 60x60 pixels. The video must be the main content of the page not a secondary element.

Video Sitemaps as an Alternative

If implementing schema markup is technically challenging video sitemaps provide similar functionality. Include video:video elements with video:thumbnail_loc, video:title, video:description, and video:content_loc or video:player_loc. Submit the video sitemap through Google Search Console.

Common Implementation Errors

Missing required properties like thumbnailUrl or uploadDate. Thumbnail image not accessible to Googlebot (blocked by robots.txt). Video not the primary content of the page. Mismatch between schema data and visible page content. Using invalid date or duration formats. Content URL pointing to a page rather than a video file.

Testing and Validation

Use Google Rich Results Test to validate your VideoObject schema. Check Google Search Console Enhancements section for Video report showing errors and warnings. Monitor video rich result impressions and clicks in GSC performance data.

Conclusion

Video schema markup is a high-impact technical SEO implementation that can significantly increase video visibility in search results. The effort to implement is relatively low compared to the potential traffic gains from video carousels and key moments features.