Video Sitemap Guide: How to Get Your Videos Indexed by Google (2026)

Short answer: A video sitemap is an XML file that tells Google where your videos are, what they are about, and how to index them. You create one by listing each video's page URL, thumbnail, title, description, and either the direct file URL or player URL -- then submit it through Google Search Console.

You uploaded a product demo to your website last month. It looks great on the page. But search "product demo" on Google, switch to the Video tab, and your video is nowhere. Meanwhile, a competitor's shaky screen recording sits in position three.

The difference is almost always a video sitemap. Google's regular crawler can find text and images on its own, but video is different. Without explicit signals, Googlebot often skips embedded videos entirely -- especially when they load behind a click, inside a JavaScript player, or from a third-party CDN.

A video sitemap fixes that. It hands Google a structured list of every video on your site: where to find it, what it covers, and what thumbnail to display. This guide covers everything from the raw XML to automated tools, so you can pick the approach that matches your technical comfort level.

What Is a Video Sitemap?

A video sitemap is an XML file -- separate from your regular sitemap -- that provides metadata about the videos hosted on your site. It follows Google's video sitemap specification and uses the http://www.google.com/schemas/sitemap-video/1.1 XML namespace. Google also supports mRSS feeds as an alternative format, though most sites use XML.

Think of your regular XML sitemap as a directory of pages. A video sitemap is a directory of videos, with each entry pointing to the page where the video appears and including structured metadata like the title, description, thumbnail URL, and duration.

When Google processes your video sitemap, it uses that information in three ways:

• Discovery: Google learns that a video exists on a specific page, even if the player loads via JavaScript or behind a user interaction.
• Rich results: The thumbnail, title, and duration can appear directly in search results as a video snippet.
• Video tab: Your video becomes eligible for Google's dedicated Video search results.

Without a sitemap, Google relies on rendering your page with a headless browser to detect videos. That process is slow, unreliable for JavaScript-heavy players, and often misses videos entirely -- particularly those behind lazy-load facades or click-to-play interactions. If you are using embed codes with deferred loading, a video sitemap is essential.

Do You Actually Need a Video Sitemap?

Sites that embed only YouTube or Vimeo videos rarely need a video sitemap -- those platforms handle their own indexing.

You do need a video sitemap if any of these apply:

• You self-host videos (on your own server, a CDN, or a platform like SmartVideo) and want them to appear in Google Video results linked to your domain.
• Your video player loads via JavaScript -- including facade patterns, lazy loading, or any player that requires a click before the video element appears in the DOM.
• You have time-sensitive video content (news, events, product launches) where waiting for Google's natural crawl cycle is too slow.
• You see Video Indexing Report errors in Google Search Console and need to give Google clearer signals.

For most business websites with self-hosted video, a video sitemap is one of the highest-impact video SEO actions you can take. According to Google's video sitemap documentation, submitting a sitemap "reduces the time it takes for us to discover your video" and is especially recommended for time-sensitive content (Google Search Central, 2026). In our experience setting up video hosting for hundreds of businesses, the difference between "invisible in Video search" and "indexed within days" almost always comes down to whether a video sitemap exists. We have seen customers go from zero video impressions in Search Console to appearing in the Video tab within 48 hours of submitting a sitemap.

How Do You Create a Video Sitemap XML?

A video sitemap is a standard XML file you create in any text editor or generate with a script.

Required Tags

Every video entry needs these fields or Google will reject it.

Copy-Paste XML Template

Here is a minimal working video sitemap you can adapt. Replace the placeholder values with your actual URLs and metadata.

<?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/product-demo/</loc>
    <video:video>
      <video:thumbnail_loc>https://example.com/thumbs/demo.jpg</video:thumbnail_loc>
      <video:title>Product Demo - How It Works</video:title>
      <video:description>A 3-minute walkthrough of the core features.</video:description>
      <video:content_loc>https://cdn.example.com/videos/demo.mp4</video:content_loc>
      <video:duration>180</video:duration>
      <video:publication_date>2026-01-15T08:00:00+00:00</video:publication_date>
    </video:video>
  </url>

  <url>
    <loc>https://example.com/tutorial/getting-started/</loc>
    <video:video>
      <video:thumbnail_loc>https://example.com/thumbs/tutorial.jpg</video:thumbnail_loc>
      <video:title>Getting Started Tutorial</video:title>
      <video:description>Step-by-step setup guide for new users.</video:description>
      <video:player_loc>https://example.com/embed/tutorial</video:player_loc>
      <video:duration>420</video:duration>
    </video:video>
  </url>

</urlset>

Save this file as video-sitemap.xml in your site's root directory (alongside your regular sitemap.xml). Each <url> block represents one page, and each <video:video> block represents one video on that page -- a single page can contain multiple video entries.

Optional Tags Worth Adding

These are not required, but they improve how Google displays your videos in results.

File limits: Each video sitemap can hold up to 50,000 URLs and must be under 50MB uncompressed (Google Sitemap Guidelines). If you exceed either limit, split into multiple sitemap files and reference them from a sitemap index file. Very few business websites come close to this limit.

How Do You Submit a Video Sitemap to Google?

You submit a video sitemap through Google Search Console in three steps.

1. Host the file on your website at a publicly accessible URL (e.g., https://yoursite.com/video-sitemap.xml). It must not be blocked by robots.txt.
2. Open Google Search Console, select your property, and navigate to Sitemaps in the left sidebar.
3. Enter the URL of your video sitemap and click Submit.

Google will download and parse the file within a few hours. Check back in the Sitemaps report for status and errors. For video-specific issues, also check Index > Video pages -- this is Google's dedicated Video Indexing Report, and it surfaces problems that the regular sitemap report misses.

Important: If your video files are served from a separate CDN domain (e.g., cdn.yoursite.com), make sure that domain is not blocked by robots.txt and that the video URLs are accessible without authentication. You do not need to verify the CDN domain in Search Console, but Googlebot must be able to reach those files.

What Is the Difference Between a Video Sitemap and VideoObject Schema?

A video sitemap and VideoObject schema markup serve different purposes -- you typically need both for full video SEO coverage.

JavaScript-loaded video players -- including facade patterns and lazy-load implementations -- are cases where both signals matter. The schema tells Google "there is a video here" even before the player initializes, while the sitemap ensures Google knows to visit that page for video content in the first place. In practice, pages with both VideoObject schema and a video sitemap give Google redundant signals, which improves your chances of appearing in video carousels.

If you use SmartVideo, the VideoObject schema half is handled for you automatically (via the WordPress plugin). The sitemap half still requires either a manual XML file or a WordPress SEO plugin.

Which Tools Generate Video Sitemaps Automatically?

WordPress SEO plugins can generate video sitemaps automatically; custom platforms require manual XML or a standalone generator.

WordPress SEO Plugins

All three detect standard <video> elements, YouTube embeds, and Vimeo embeds. For custom players like SmartVideo's <smartvideo> tag, the plugins typically pick up the VideoObject JSON-LD that SmartVideo outputs and use that data to populate the video sitemap entry. If your WordPress video setup combines SmartVideo with one of these SEO plugins, you get both structured data and sitemap coverage without manual XML editing.

Custom Sites and Non-WordPress Platforms

If you are on Shopify, Squarespace, a static site, or any platform without an SEO plugin that generates video sitemaps, your options are:

• Build the XML by hand using the template above. For sites with fewer than 20 videos, this takes about 15 minutes and rarely needs updating.
• Script it -- write a build step that reads your video data (from a CMS API, database, or flat file) and generates the XML dynamically. Python, Node, and PHP all have sitemap libraries that support the video namespace.
• Use an online generator -- tools like TechnicalSEO.com's Video Sitemap Generator let you input video data manually and export the XML.

Why Is My Video Not Showing Up in Google?

Google Search Console's Video Indexing Report (under Index > Video pages) surfaces specific errors when videos fail to index.

The most frustrating error is "Video is not the main content of the page." Google is strict about this -- their video best practices state that the video must be "the main content" of the page (Google Video Best Practices, 2026). A blog post with an embedded demo video in the middle of 2,000 words of text usually will not qualify. If you want blog-embedded videos indexed, consider creating a dedicated "watch" page for each video and linking to it from the blog post.

Frequently Asked Questions

Final Thoughts

A video sitemap is not glamorous, but it is one of the few video SEO actions with a clear, measurable payoff. You create a file, submit it, and within days you can see whether Google has started indexing your videos in the Video Indexing Report.

The biggest mistake is assuming Google will figure out your videos on its own. It will not -- especially if your player loads dynamically, your files live on a CDN, or your videos are supplementary content on a text-heavy page. A video sitemap removes the guesswork.

Combine it with VideoObject structured data (which your embed solution may already handle) and you have given Google every signal it needs to discover, understand, and surface your videos.