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.
$npx -y skills add thedaviddias/Front-End-Checklist --skill video --agent claude-code
Installs into .claude/skills of the current project.
Are you the author of Video?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/thedaviddias-video)
---
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/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 `name` (video title), `description` (video description), `thumbnailUrl` (absolute URL to thumbnail image), `uploadDate` (ISO 8601 format), and either `contentUrl` or `embedUrl`. Validate with the Rich Results Test.
## Explain
Explain how VideoObject schema enables video-specific rich results, which properties are required vs. recommended by Google, and the difference between `contentUrl` (direct file) and `embedUrl` (embed iframe URL).
## Code Review
Review metadata generation, rendered HTML, structured data, and response headers related to Add VideoObject schema to video pages. Flag exact routes or templates where search-facing output violates the rule, and describe how to verify the final page output.
---
For full implementation details, code examples, and framework-specific guidance,
see `references/rule.md`.
Rule page: https://frontendchecklist.io/rules/seo/video
