Video sitemap submission: The Complete 2026 Guide
A complete guide to creating, validating, and submitting video sitemaps to Google Search Console for comprehensive video content indexing.
- A video sitemap is an XML file that provides search engines with precise metadata about every video on your website.
- Video structured data VideoObject JSON-LD and video sitemaps serve complementary but distinct roles.
- A valid video sitemap extends the standard XML sitemap protocol with video-specific tags from the video namespace.
- Before submission, validate your XML against the video sitemap schema using Google's sitemap testing tool or a generic XML validator.
- For sites with frequently changing video libraries, automate sitemap generation.
- Generate and submit a video sitemap covering every video page on the site.
A video sitemap is an XML file that provides search engines with precise metadata about every video on your website. Unlike a regular sitemap that lists pages, a video sitemap tells Google the exact location of each video file, its thumbnail, its duration, its title, and its description. For...
What is a video sitemap?
A video sitemap is an XML file that provides search engines with precise metadata about every video on your website. Unlike a regular sitemap that lists pages, a video sitemap tells Google the exact location of each video file, its thumbnail, its duration, its title, and its description. For sites with hundreds or thousands of videos, a dedicated video sitemap is far more reliable than relying on embedded schema alone.
When to use a video sitemap over schema
Video structured data (VideoObject JSON-LD) and video sitemaps serve complementary but distinct roles. Schema markup goes on the page itself and is evaluated by Google's rendering pipeline. A video sitemap is submitted directly via Search Console and bypasses the rendering step entirely. Use a video sitemap when:
- Your videos are loaded dynamically via JavaScript that Googlebot may not execute fully.
- Your videos are hosted on a CDN or subdomain separate from the page domain.
- You need to submit metadata for videos that exist on pages not yet indexed.
- You want explicit control over which videos Google indexes and which it skips.
Video sitemap XML structure
A valid video sitemap extends the standard XML sitemap protocol with video-specific tags from the video namespace.
<?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/tutorial</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumbnails/tutorial.jpg</video:thumbnail_loc>
<video:title>How to Build a Video Sitemap in 2026</video:title>
<video:description>A complete walkthrough of video sitemap creation, validation, and submission.</video:description>
<video:content_loc>https://cdn.example.com/videos/tutorial.mp4</video:content_loc>
<video:duration>485</video:duration>
<video:publication_date>2026-06-30T10:00:00Z</video:publication_date>
<video:family_friendly>yes</video:family_friendly>
</video:video>
</url>
</urlset>
Required fields
<video:thumbnail_loc>-- Public URL to the video thumbnail (1280x720 recommended).<video:title>-- Video title, matching the page title where feasible.<video:description>-- A 1-to-2-sentence description.
Important optional fields
<video:content_loc>-- Direct URL to the video file. Required if the video is hosted on your own servers.<video:player_loc>-- URL to an embeddable SWF or HTML5 player. Use instead ofcontent_locif hosting on YouTube or Vimeo.<video:duration>-- Video length in seconds (integer, max 28800 for 8 hours).<video:publication_date>-- ISO 8601 date of original publication.
Submitting the sitemap to Google
- Generate the video sitemap XML file and place it at the root of your domain (e.g.,
https://example.com/video-sitemap.xml). - Open Google Search Console, navigate to Sitemaps, and enter the video sitemap URL.
- Click Submit. Google will fetch, parse, and begin crawling the listed video URLs.
- Monitor the Sitemaps report for errors. Pay attention to "URL not available to Google" and "Couldn't fetch" warnings.
Validating your video sitemap
Before submission, validate your XML against the video sitemap schema using Google's sitemap testing tool or a generic XML validator. Common issues include missing required tags, improperly escaped characters in descriptions, and content_loc URLs blocked by robots.txt.
Automating sitemap generation
For sites with frequently changing video libraries, automate sitemap generation. Most static site generators and CMS platforms offer plugins or modules for video sitemap generation. Custom scripts that query your video database and produce XML output are straightforward to build with any language that supports XML templating.
Closing audit
Generate and submit a video sitemap covering every video page on the site. Validate the XML for required tag completeness. Check Search Console 48 hours after submission for indexing status. Cross-reference the sitemap's listed videos against a crawl log to confirm that Googlebot is hitting all video URLs. Review the Sitemaps error report weekly for the first month and correct any "Couldn't fetch" or "Blocked by robots.txt" entries immediately.
Citations
- Google Search Central. "Video sitemaps." https://developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps
- Sitemaps.org. "Video sitemap XML schema." https://www.sitemaps.org/video-sitemap.html
- Google Search Central. "Submit a sitemap." https://developers.google.com/search/docs/crawling-indexing/sitemaps/submit-sitemap
- W3C. "XML Schema." https://www.w3.org/XML/Schema