Optimizing SEO for Video Content (Video Schema, Video Sitemap)
Google displays video in separate Video Search block and in Universal Results with video preview. Without structured data and video sitemap, search engine may ignore video even with rich content. Two main tools: VideoObject schema markup and XML Video Sitemap.
VideoObject: Structured Data
Markup communicates to Google: name, description, duration, publication date, thumbnail URL. Without it, bot extracts data unreliably.
Minimum required fields:
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Choose a Laptop: 5 Criteria",
"description": "Breaking down CPU, RAM, display, battery and weight.",
"thumbnailUrl": "https://example.com/thumbnails/laptop-guide.jpg",
"uploadDate": "2024-09-15T10:00:00+03:00",
"duration": "PT12M34S",
"contentUrl": "https://example.com/videos/laptop-guide.mp4",
"embedUrl": "https://www.youtube.com/embed/VIDEO_ID"
}
For enhanced snippet:
{
"hasPart": [
{
"@type": "Clip",
"name": "CPU and Performance",
"startOffset": 45,
"endOffset": 180,
"url": "https://example.com/article/laptop-guide#processor"
}
],
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": {"@type": "WatchAction"},
"userInteractionCount": 45230
}
}
hasPart with Clip array — Key Moments in Google Search. Significantly boost CTR.
duration format: ISO 8601 — PT12M34S = 12 minutes 34 seconds.
thumbnailUrl — provide three sizes: 1:1, 4:3, 16:9. Minimum 60×30px, prefer 1280×720.
YouTube Video: Special Notes
If video on YouTube and embedded via <iframe>, schema still needed:
{
"embedUrl": "https://www.youtube.com/embed/dQw4w9WgXcQ",
"thumbnailUrl": "https://img.youtube.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
"uploadDate": "2024-09-15",
"duration": "PT3M32S"
}
YouTube auto-generates preview: https://img.youtube.com/vi/{VIDEO_ID}/maxresdefault.jpg. Always available.
Video Sitemap
XML map for videos — additional way to tell Google about video content.
<?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/articles/how-to-choose-laptop/</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumbnails/laptop-guide.jpg</video:thumbnail_loc>
<video:title>How to Choose Laptop for Work</video:title>
<video:description>Breaking down CPU, RAM, display and battery.</video:description>
<video:content_loc>https://example.com/videos/laptop-guide.mp4</video:content_loc>
<video:duration>754</video:duration>
<video:publication_date>2024-09-15T10:00:00+03:00</video:publication_date>
<video:tag>laptops</video:tag>
</video:video>
</url>
</urlset>
<video:duration> — in seconds (not ISO format like schema).
Register in GSC: Settings → Sitemaps → Add new sitemap.
Laravel Video Sitemap Generation
class VideoSitemapController extends Controller
{
public function index(): Response
{
$articles = Article::with('video')
->whereHas('video')
->where('status', 'published')
->get();
return response()
->view('sitemaps.video', compact('articles'))
->header('Content-Type', 'application/xml');
}
}
Requirements for Self-Hosted Video
- Accessible to Googlebot: verify via
curl -A "Googlebot/2.1" https://example.com/videos/file.mp4 -I - Supported formats: MP4 (H.264), WebM, OGV
- Not blocked by robots.txt
- Support Range requests for preview
# nginx: Range request support
location ~* \.(mp4|webm)$ {
mp4;
mp4_buffer_size 1m;
mp4_max_buffer_size 5m;
}
Verification
# Google Rich Results Test
curl "https://validator.schema.org/?url=https://example.com/article/laptop-guide/"
GSC: Enhancement → Videos — errors and warnings on VideoObject markup.
Timeline
VideoObject schema + Video Sitemap for existing content (up to 50 videos) — 2–3 days. Auto-generation setup on publication — 1–2 days. Key Moments (Clip) requires manual timestamps — about 30 minutes per video.







