| name | video |
| description | Use when applies to any page embedding or hosting video content (YouTube, Vimeo, self-hosted). Use when adding video content to a site or auditing structured data coverage. |
| metadata | {"category":"seo","priority":"medium","difficulty":"intermediate","estimatedTime":"10","source":"frontendchecklist.io","url":"https://frontendchecklist.io/en/rules/seo/video"} |
Add VideoObject schema to video pages
Pages with valid VideoObject schema are eligible for video-specific rich results and carousels in Google Search — a visibility advantage that pages without schema cannot access.
Quick Reference
- Add
VideoObject JSON-LD schema to every page with embedded video content
- Required properties:
name, description, thumbnailUrl, uploadDate
- Recommended:
contentUrl (direct video file) or embedUrl (iframe embed URL)
- Valid VideoObject schema can earn video carousels and rich results in Google Search and Google Discover
Check
Find pages with embedded <video> elements, YouTube iframes, or Vimeo players. Check for a <script type='application/ld+json'> block containing "@type": "VideoObject". Verify required properties are present: name, description, thumbnailUrl, uploadDate. Run through Google's Rich Results Test.
Fix
Add a VideoObject JSON-LD block to each page with video. Populate (video title), (video description), (absolute URL to thumbnail image), (ISO 8601 format), and either or . Validate with the Rich Results Test.
