Video sitemaps: The Complete 2026 Guide
A video sitemap lists video content for search engine crawlers. Video discovery through standard HTML parsing is unreliable. Many video players use...
- A video sitemap lists video content for search engine crawlers.
- You must provide either <video:content_loc or <video:player_loc .
- Google indexes videos in common web formats.
- VideoObject structured data from Schema.org provides richer markup.
- Videos with incorrect duration values fail validation.
- Verify that every video entry includes required elements.
A video sitemap lists video content for search engine crawlers. Video discovery through standard HTML parsing is unreliable. Many video players use JavaScript to load content, which crawlers may not execute fully. A video sitemap gives search engines the raw video metadata directly. Google uses...
Purpose of video sitemaps
A video sitemap lists video content for search engine crawlers. Video discovery through standard HTML parsing is unreliable. Many video players use JavaScript to load content, which crawlers may not execute fully. A video sitemap gives search engines the raw video metadata directly.
Google uses video sitemaps to index video content for Video Search and universal search results. Properly submitted videos can appear in video carousels, rich results, and blended search results. The official guide is at developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps.
Schema elements
The video sitemap schema extends the standard XML namespace with xmlns:video="http://www.google.com/schemas/sitemap-video/1.1". Required elements include <video:video> containing <video:content_loc> (video file location) or <video:player_loc> (SWF player URI), plus <video:title>, and <video:description>.
Optional elements improve ranking potential. <video:thumbnail_loc> points to the thumbnail image. <video:duration> specifies length in seconds. <video:publication_date> tells Google when the video was published. <video:category> and <video:tag> help classify content. Google recommends using all optional fields for best indexing results.
Video content location rules
You must provide either <video:content_loc> or <video:player_loc>. The content URL points directly to the video file. The player URL points to a page that plays the video. Both require fully qualified URLs on the same domain as the sitemap.
Videos on CDNs or separate domains work if those domains serve the content. The video files must be accessible to Googlebot. Password protected, login gated, or blocked videos will not be indexed. The technical requirements are detailed at developers.google.com/search/docs/crawling-indexing/video-indexing.
Supported video formats
Google indexes videos in common web formats. MP4, WebM, and Ogg are preferred. The video should have a minimum duration of 30 seconds to appear in video search results. Flash only videos are not supported as of 2026.
Thumbnail images must be at least 160 by 90 pixels and no larger than 1920 by 1080. Large thumbnails improve click through rates in search results. The file format must be JPEG, PNG, or WebP. Thumbnails must not contain embedded text overlays or promotional graphics.
Video sitemaps versus VideoObject schema
VideoObject structured data from Schema.org provides richer markup. It describes the video in page HTML with JSON-LD. Google supports both approaches. A video sitemap is the fallback when structured data cannot be added to pages.
Many sites use both. The structured data tells Google about the video on the page. The sitemap ensures every video gets submitted even if structured data parsing fails. Search Engine Land compared both approaches at searchengineland.com/video-seo-structured-data-sitemaps-445012.
Common video indexing problems
Videos with incorrect duration values fail validation. Duration must match the actual video length within a tolerance of 10 seconds. Videos marked as live streams get different treatment than on-demand content.
Low quality videos with limited text context tend to get less indexing priority. Each video needs surrounding text on the landing page. The page title and description should match the video topic. Ahrefs has a video SEO checklist at ahrefs.com/blog/video-seo.
The video sitemap audit
Verify that every video entry includes required elements. Check that content URLs resolve and serve video files. Confirm that player URLs load and play correctly. Validate duration values against actual video lengths.
Note the gap between submitted videos and videos indexed in Google Video Search. A low rate indicates missing text context, poor metadata quality, or technical delivery problems. Fix those issues before publishing more video content.
Audit quarterly.