SEO On-Page: Video Optimization
Guides video optimization for Google Search (main results, video mode, Google Images, Discover), video sitemap, VideoObject schema, and indexing. Note: Google now prioritizes YouTube video results in search; YouTube + Reddit comprise ~78% of social media citations in AI Overviews. For YouTube-specific optimization, see youtube-seo; for GEO distribution via YouTube, see generative-engine-optimization. References: Google Video SEO, Semrush YouTube SEO.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Scope
- Discovery & indexing: HTML embed elements, video sitemap
- Metadata: Title, description, thumbnail; stable URLs
- Structured data: VideoObject schema
- Features: Video preview, key moments (Clip, SeekToAction), LIVE badge
- YouTube prioritization: Google favors YouTube in search; embed or host on YouTube for GEO citation
YouTube in Google Search (2025+)
Google prioritizes YouTube video results across search. YouTube receives 48.6B monthly visits (second to Google.com) and is treated as core search infrastructure for AI-driven discovery. Search Engine Land
| Context |
Implication |
| AI Overviews |
YouTube citations surged 25.21% since Jan 2025; instructional (+35.6%), visual demos (+32.5%); long-form dominates (94%) |
| GEO |
YouTube + Reddit = ~78% of social media citations; Perplexity (38.7%) and Google AI Overviews (36.6%) drive most YouTube citations |
| Strategy |
Embed YouTube on site pages for dual indexing; or host on YouTube for GEO citation. See youtube-seo, generative-engine-optimization |
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for brand and page context.
Identify:
- Hosting: Self-hosted vs YouTube/Vimeo embed
- Page type: Dedicated watch page vs supplementary (e.g. blog with embedded video)
- Features needed: Preview, key moments, LIVE badge
1. Discovery & Indexing
Use Standard HTML Embed Elements
Google finds videos in <video>, <embed>, <iframe>, or <object>. Do not use fragment identifiers to load video; avoid requiring user interaction (click, swipe) to load.
| Do |
Don't |
<video><source src="...mp4"/></video> |
Fragment-only load; JS-injected without fallback |
<iframe src="https://youtube.com/embed/..."> |
Hide video behind paywall without paywall structured data |
JavaScript injection: If video is injected via JS, ensure it appears in rendered HTML; use URL Inspection in Search Console. If using Media Source API, inject HTML video container even when API fails so Google can find metadata.
Video Sitemap
Submit a video sitemap to help Google discover videos. Use <video:video> extension; <loc> = watch page URL.
Structure (from Google):
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
<url>
<loc>https://example.com/videos/watch-page.html</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumbs/123.jpg</video:thumbnail_loc>
<video:title>Grilling steaks for summer</video:title>
<video:description>Bob shows you how to grill steaks perfectly.</video:description>
<video:player_loc>https://example.com/player?video=123</video:player_loc>
</video:video>
</url>
</urlset>
See xml-sitemap for sitemap index. Video sitemap is an extension; can be standalone or combined.
Indexing Requirements
- Watch page must be indexed and perform well in search
- Video embedded on watch page; not hidden behind elements
- Thumbnail: Valid, stable URL; ≥60×30 px; ≥80% alpha >250 (no heavy transparency)
- Supported formats: 3GP, 3G2, ASF, AVI, DivX, M2V, M3U, M3U8, M4V, MKV, MOV, MP4, MPEG, OGV, WebM, WMV, etc. Data URLs not supported.
Dedicated Watch Page
For video features (main results, video mode, key moments, LIVE badge), create a dedicated watch page per video—page whose primary purpose is to display that video. Examples: video landing page, episode player page, news video page. Not watch pages: blog with embedded video, product page with 360° video, category page with multiple videos.
2. Stable URLs
- Thumbnail: Stable URL; CDNs with fast-expiring URLs can prevent indexing
- Content URL: Stable for video preview and key moments; use
contentUrl in VideoObject
- Player URL: Stable for
embedUrl / player_loc
3. Thumbnail & Metadata
Thumbnail Sources (in priority order)
| Source |
How |
<video> poster |
poster attribute |
| Video sitemap |
<video:thumbnail_loc> |
| VideoObject |
thumbnailUrl |
| OGP |
og:video:image |
Use same thumbnail URL across all metadata sources.
Thumbnail Specs
| Spec |
Requirement |
| Formats |
BMP, GIF, JPEG, PNG, WebP, SVG, AVIF |
| Size |
Min 60×30 px; larger preferred |
| Transparency |
≥80% of pixels with alpha >250 |
| Access |
Must be crawlable (no robots.txt block, no login) |
Unique Metadata per Video
Provide unique thumbnailUrl, name, and description for each video in structured data and sitemap. Consistency with visible content is required.
4. VideoObject Schema
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Grilling steaks for summer",
"description": "Bob shows you how to grill steaks perfectly every time.",
"thumbnailUrl": "https://example.com/thumbs/123.jpg",
"uploadDate": "2025-01-15T08:00:00Z",
"contentUrl": "https://example.com/video/123.mp4",
"embedUrl": "https://example.com/player?video=123"
}
Required for rich results: thumbnailUrl, name, description. Add contentUrl for video preview and key moments. See schema-markup for full VideoObject; serp-features for Video SERP feature.
5. Video Features
Video Preview
Google selects short clips as dynamic previews. Allow Google to fetch video file; use max-video-preview robots meta to limit duration.
Key Moments (Chapters)
| Method |
Use |
| Clip |
Exact start/end + label per segment; all languages |
| SeekToAction |
Tell Google where timestamps live in URL; auto-detect; supported languages: en, es, pt, it, zh, fr, ja, de, tr, ko, nl, ru |
| YouTube |
Timestamps in description; see youtube-seo |
Disable key moments: nosnippet meta.
LIVE Badge
Use BroadcastEvent schema for live streams to show "LIVE" in results.
6. Allow Google to Fetch Video File
For video preview and key moments, Google must fetch the actual video bytes. Do not block contentUrl with noindex or robots.txt. Use stable URLs; ensure both watch page host and video/CDN host have sufficient capacity for crawling.
7. Third-Party Embeds (YouTube, Vimeo)
Google may index both your page and the platform's page. For your watch page: still add VideoObject and optionally video sitemap. For more features (preview, key moments), confirm the platform allows Google to fetch video files.
8. Removal & Restrictions
- Remove: 404 on watch page, or
noindex; or set expires in schema / <video:expiration_date> in sitemap
- Geo-restrict:
regionsAllowed or ineligibleRegion in VideoObject; <video:restriction> in sitemap
9. SafeSearch & Monitoring
- Mark pages appropriately for SafeSearch if content is adult. See Google SafeSearch.
- Search Console: Video indexing report; Video rich results report; Performance filtered by "Video" search appearance.
Specs by Context
| Context |
Priority |
Notes |
| Website video |
VideoObject, sitemap, thumbnail |
This skill |
| YouTube |
Title, description, chapters, thumbnail |
See youtube-seo |
| GEO / AI citation |
YouTube distribution; long-form |
See generative-engine-optimization |
| Featured Snippet (video) |
Video schema; timestamps |
See featured-snippet |
Related Skills
- youtube-seo: YouTube titles, descriptions, thumbnails, chapters
- schema-markup: VideoObject, BroadcastEvent; rich results
- serp-features: Video SERP feature; rich results
- featured-snippet: Video snippet format
- xml-sitemap: Video sitemap extension
- google-search-console: Video indexing report; Video rich results
1---
2name: video-optimization
3description: When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites. Also use when the user mentions "video SEO," "video sitemap," "VideoObject," "video thumbnail," "video indexing," "video preview," "key moments," "Clip schema," or "embedded video optimization." For page template, use article-page-generator.
4metadata:
5 version: 1.0.1
6---
7
8# SEO On-Page: Video Optimization
9
10Guides video optimization for Google Search (main results, video mode, Google Images, Discover), video sitemap, VideoObject schema, and indexing. **Note**: Google now prioritizes YouTube video results in search; YouTube + Reddit comprise ~78% of social media citations in AI Overviews. For YouTube-specific optimization, see **youtube-seo**; for GEO distribution via YouTube, see **generative-engine-optimization**. References: [Google Video SEO](https://developers.google.com/search/docs/appearance/video), [Semrush YouTube SEO](https://www.semrush.com/blog/youtube-seo/).
11
12**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
13
14## Scope
15
16- **Discovery & indexing**: HTML embed elements, video sitemap
17- **Metadata**: Title, description, thumbnail; stable URLs
18- **Structured data**: VideoObject schema
19- **Features**: Video preview, key moments (Clip, SeekToAction), LIVE badge
20- **YouTube prioritization**: Google favors YouTube in search; embed or host on YouTube for GEO citation
21
22## YouTube in Google Search (2025+)
23
24**Google prioritizes YouTube video results** across search. YouTube receives 48.6B monthly visits (second to Google.com) and is treated as core search infrastructure for AI-driven discovery. [Search Engine Land](https://searchengineland.com/youtube-seo-ai-overviews-467253)
25
26| Context | Implication |
27|---------|-------------|
28| **AI Overviews** | YouTube citations surged 25.21% since Jan 2025; instructional (+35.6%), visual demos (+32.5%); long-form dominates (94%) |
29| **GEO** | YouTube + Reddit = ~78% of social media citations; Perplexity (38.7%) and Google AI Overviews (36.6%) drive most YouTube citations |
30| **Strategy** | Embed YouTube on site pages for dual indexing; or host on YouTube for GEO citation. See **youtube-seo**, **generative-engine-optimization** |
31
32## Initial Assessment
33
34**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for brand and page context.
35
36Identify:
371. **Hosting**: Self-hosted vs YouTube/Vimeo embed
382. **Page type**: Dedicated watch page vs supplementary (e.g. blog with embedded video)
393. **Features needed**: Preview, key moments, LIVE badge
40
41---
42
43## 1. Discovery & Indexing
44
45### Use Standard HTML Embed Elements
46
47Google finds videos in `<video>`, `<embed>`, `<iframe>`, or `<object>`. **Do not** use fragment identifiers to load video; avoid requiring user interaction (click, swipe) to load.
48
49| Do | Don't |
50|----|-------|
51| `<video><source src="...mp4"/></video>` | Fragment-only load; JS-injected without fallback |
52| `<iframe src="https://youtube.com/embed/...">` | Hide video behind paywall without paywall structured data |
53
54**JavaScript injection**: If video is injected via JS, ensure it appears in rendered HTML; use URL Inspection in Search Console. If using Media Source API, inject HTML video container even when API fails so Google can find metadata.
55
56### Video Sitemap
57
58Submit a [video sitemap](https://developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps) to help Google discover videos. Use `<video:video>` extension; `<loc>` = watch page URL.
59
60**Structure** (from Google):
61
62```xml
63<?xml version="1.0" encoding="UTF-8"?>
64<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
65 xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
66 <url>
67 <loc>https://example.com/videos/watch-page.html</loc>
68 <video:video>
69 <video:thumbnail_loc>https://example.com/thumbs/123.jpg</video:thumbnail_loc>
70 <video:title>Grilling steaks for summer</video:title>
71 <video:description>Bob shows you how to grill steaks perfectly.</video:description>
72 <video:player_loc>https://example.com/player?video=123</video:player_loc>
73 </video:video>
74 </url>
75</urlset>
76```
77
78See **xml-sitemap** for sitemap index. Video sitemap is an extension; can be standalone or combined.
79
80### Indexing Requirements
81
82- **Watch page** must be indexed and perform well in search
83- **Video embedded** on watch page; not hidden behind elements
84- **Thumbnail**: Valid, stable URL; ≥60×30 px; ≥80% alpha >250 (no heavy transparency)
85- **Supported formats**: 3GP, 3G2, ASF, AVI, DivX, M2V, M3U, M3U8, M4V, MKV, MOV, MP4, MPEG, OGV, WebM, WMV, etc. **Data URLs not supported.**
86
87### Dedicated Watch Page
88
89For video features (main results, video mode, key moments, LIVE badge), create a **dedicated watch page** per video—page whose primary purpose is to display that video. Examples: video landing page, episode player page, news video page. **Not** watch pages: blog with embedded video, product page with 360° video, category page with multiple videos.
90
91---
92
93## 2. Stable URLs
94
95- **Thumbnail**: Stable URL; CDNs with fast-expiring URLs can prevent indexing
96- **Content URL**: Stable for video preview and key moments; use `contentUrl` in VideoObject
97- **Player URL**: Stable for `embedUrl` / `player_loc`
98
99---
100
101## 3. Thumbnail & Metadata
102
103### Thumbnail Sources (in priority order)
104
105| Source | How |
106|--------|-----|
107| `<video>` poster | `poster` attribute |
108| Video sitemap | `<video:thumbnail_loc>` |
109| VideoObject | `thumbnailUrl` |
110| OGP | `og:video:image` |
111
112Use **same thumbnail URL** across all metadata sources.
113
114### Thumbnail Specs
115
116| Spec | Requirement |
117|------|-------------|
118| Formats | BMP, GIF, JPEG, PNG, WebP, SVG, AVIF |
119| Size | Min 60×30 px; larger preferred |
120| Transparency | ≥80% of pixels with alpha >250 |
121| Access | Must be crawlable (no robots.txt block, no login) |
122
123### Unique Metadata per Video
124
125Provide **unique** `thumbnailUrl`, `name`, and `description` for each video in structured data and sitemap. Consistency with visible content is required.
126
127---
128
129## 4. VideoObject Schema
130
131```json
132{
133 "@context": "https://schema.org",
134 "@type": "VideoObject",
135 "name": "Grilling steaks for summer",
136 "description": "Bob shows you how to grill steaks perfectly every time.",
137 "thumbnailUrl": "https://example.com/thumbs/123.jpg",
138 "uploadDate": "2025-01-15T08:00:00Z",
139 "contentUrl": "https://example.com/video/123.mp4",
140 "embedUrl": "https://example.com/player?video=123"
141}
142```
143
144**Required for rich results**: `thumbnailUrl`, `name`, `description`. Add `contentUrl` for video preview and key moments. See **schema-markup** for full VideoObject; **serp-features** for Video SERP feature.
145
146---
147
148## 5. Video Features
149
150### Video Preview
151
152Google selects short clips as dynamic previews. Allow Google to fetch video file; use `max-video-preview` robots meta to limit duration.
153
154### Key Moments (Chapters)
155
156| Method | Use |
157|--------|-----|
158| **Clip** | Exact start/end + label per segment; all languages |
159| **SeekToAction** | Tell Google where timestamps live in URL; auto-detect; supported languages: en, es, pt, it, zh, fr, ja, de, tr, ko, nl, ru |
160| **YouTube** | Timestamps in description; see **youtube-seo** |
161
162Disable key moments: `nosnippet` meta.
163
164### LIVE Badge
165
166Use `BroadcastEvent` schema for live streams to show "LIVE" in results.
167
168---
169
170## 6. Allow Google to Fetch Video File
171
172For **video preview** and **key moments**, Google must fetch the actual video bytes. Do not block `contentUrl` with noindex or robots.txt. Use stable URLs; ensure both watch page host and video/CDN host have sufficient capacity for crawling.
173
174---
175
176## 7. Third-Party Embeds (YouTube, Vimeo)
177
178Google may index both your page and the platform's page. For your watch page: still add VideoObject and optionally video sitemap. For more features (preview, key moments), confirm the platform allows Google to fetch video files.
179
180---
181
182## 8. Removal & Restrictions
183
184- **Remove**: 404 on watch page, or `noindex`; or set `expires` in schema / `<video:expiration_date>` in sitemap
185- **Geo-restrict**: `regionsAllowed` or `ineligibleRegion` in VideoObject; `<video:restriction>` in sitemap
186
187---
188
189## 9. SafeSearch & Monitoring
190
191- Mark pages appropriately for SafeSearch if content is adult. See [Google SafeSearch](https://developers.google.com/search/docs/appearance/safesearch).
192- **Search Console**: Video indexing report; Video rich results report; Performance filtered by "Video" search appearance.
193
194---
195
196## Specs by Context
197
198| Context | Priority | Notes |
199|---------|----------|-------|
200| **Website video** | VideoObject, sitemap, thumbnail | This skill |
201| **YouTube** | Title, description, chapters, thumbnail | See **youtube-seo** |
202| **GEO / AI citation** | YouTube distribution; long-form | See **generative-engine-optimization** |
203| **Featured Snippet (video)** | Video schema; timestamps | See **featured-snippet** |
204
205---
206
207## Related Skills
208
209- **youtube-seo**: YouTube titles, descriptions, thumbnails, chapters
210- **schema-markup**: VideoObject, BroadcastEvent; rich results
211- **serp-features**: Video SERP feature; rich results
212- **featured-snippet**: Video snippet format
213- **xml-sitemap**: Video sitemap extension
214- **google-search-console**: Video indexing report; Video rich results
gabrielmoreira