How to Submit a Video Sitemap to Google Search Console (2026 Guide)

If you have video content on your site, there is a real chance Google is missing most of it. Googlebot is good at finding pages but inconsistent at detecting embedded video players, especially when those embeds load via JavaScript. A video sitemap tells Google explicitly which pages host videos and what each video is about. This guide covers what a video sitemap is, the five XML tags Google requires for every entry, and how to submit a video sitemap to Google Search Console from upload through the Video Indexing Report.

What is a video sitemap

A video sitemap is an XML file that follows the standard Sitemaps Protocol 0.9 with an extra video namespace. For each page on your site that hosts a video, you add a <url> entry containing the page URL plus a nested <video:video> block with metadata: title, description, thumbnail URL, and either the direct video file URL or the embed player URL. Google reads the file when you submit it to Search Console and uses it to discover videos that crawling alone might miss.

You have two options for delivery. You can host a standalone video-sitemap.xml file alongside your regular sitemap, or you can add video tags directly inside an existing sitemap that lists all your pages. Both are accepted. The standalone file is easier to debug and update, so most sites with more than a handful of videos use that.

Why bother with a video sitemap

Three reasons. First, discovery: Googlebot does not always identify embedded video players, especially YouTube iframes loaded by JavaScript or videos behind a click-to-play overlay. A sitemap entry guarantees the video is on Google’s radar. Second, metadata accuracy: you control the title, description, and thumbnail that show in Google Video search instead of leaving Google to guess from the surrounding page text. Third, indexing speed: sitemap-submitted videos typically show up in the Search Console Video Indexing Report within 7 to 14 days, often faster than discovery via normal crawling.

If your videos are core to your traffic (tutorials, product demos, course content, news clips), the sitemap is non-optional. If videos are decorative or supplementary, you can skip it without losing much.

The 5 required tags in every video sitemap entry

Google’s official video sitemap documentation lists 5 required elements for every entry. Skip any of them and Search Console flags the entry with a “missing required field” error.

• <loc> – the page URL that hosts the video, not the video file itself. Example: https://example.com/tutorial-page.
• <video:title> – the video title, max 100 characters. This is what appears in Google Video search results.
• <video:description> – plain text description, max 2,048 characters. Shows alongside the title in search results.
• <video:thumbnail_loc> – URL of the thumbnail image. Minimum 160 x 90 pixels, max 1920 x 1080. JPG, PNG, and GIF accepted.
• <video:content_loc> OR <video:player_loc> – either the URL of the raw video file (preferred, usually a .mp4) or the URL of the embed player (typically an iframe URL). At least one is required.

Optional but recommended tags: <video:duration> (seconds), <video:publication_date> (ISO 8601 date), <video:family_friendly> (yes / no), <video:requires_subscription>, and <video:platform> (restrict to web, mobile, or TV).

A real video sitemap example

Here is a minimal but valid video-sitemap.xml entry. Copy this pattern and adapt the values to your site.

<?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/css-grid-tutorial</loc>
    <video:video>
      <video:thumbnail_loc>https://example.com/thumbs/grid.jpg</video:thumbnail_loc>
      <video:title>CSS Grid Layout in 10 Minutes</video:title>
      <video:description>A complete walkthrough of CSS Grid for beginners, covering rows, columns, gap, and grid-area.</video:description>
      <video:content_loc>https://example.com/videos/grid.mp4</video:content_loc>
      <video:duration>612</video:duration>
      <video:publication_date>2026-04-15T08:30:00+00:00</video:publication_date>
      <video:family_friendly>yes</video:family_friendly>
    </video:video>
  </url>
</urlset>

For multiple videos, repeat the <url> block. One sitemap file can hold up to 50,000 entries or 50 MB uncompressed, whichever comes first. Beyond that, split into multiple sitemaps and reference them from a sitemap index.

How to submit a video sitemap to Google Search Console

Once your video-sitemap.xml file is built, the submission flow takes about five minutes.

1. Upload the file to your domain. The conventional location is the site root (https://yoursite.com/video-sitemap.xml), but any public path on the same domain works. WordPress users with Yoast or Rank Math installed can also configure those plugins to generate and host it automatically.
2. Verify the URL is reachable. Open the file URL in your browser. You should see the raw XML render or download. If you get a 404, 403, or HTML page instead, the file is not where Google will look.
3. Open Google Search Console at search.google.com/search-console and select the verified property (the domain or URL prefix you confirmed ownership of).
4. Submit the sitemap. In the left navigation, go to Indexing > Sitemaps. Paste the full URL of your video sitemap into the “Add a new sitemap” field, then click Submit. The status should change to “Success” within a few minutes.
5. Track indexing in Pages > Video. The Video Indexing Report shows how many videos Google has discovered, how many are indexed, and any errors that block indexing. Most sites see their first videos appear within 7 to 14 days, faster for high-authority sites.

You only need to resubmit if you add or remove videos and want to nudge re-crawling. Otherwise Google revisits the sitemap on its own schedule (typically every few days for active sites).

Use Yoast SEO, Rank Math, or AIOSEO to auto-generate

If you run WordPress, the major SEO plugins can produce a video sitemap automatically by detecting video embeds on your pages. Yoast SEO has a video sitemap module (paid Premium add-on). Rank Math includes video sitemap in the free version. AIOSEO Pro has it too. The trade-off: these plugins generate the sitemap from your existing content, so the metadata is whatever the plugin can extract from embed URLs and surrounding page text. For more control over title, description, and thumbnail per video, you write the XML by hand or use a dedicated generator.

If you do not want to install a plugin or hand-roll the XML, the free Pixellize Video Sitemap Generator crawls your site, detects YouTube, Vimeo, and HTML5 video embeds across up to 250 pages, and outputs a Google-compliant XML file with all 5 required tags populated. Runs in your browser, no signup, no plugin install.

Common errors Google Search Console flags

• Missing thumbnail. Most common error. <video:thumbnail_loc> must be a real image URL that returns HTTP 200 and is at least 160 x 90 pixels.
• Invalid date format. <video:publication_date> must be ISO 8601 (2026-04-15T08:30:00+00:00). Just a date string like April 15, 2026 fails.
• Inaccessible content_loc. If the video file URL returns 404 or 403 (often because it sits behind a login or CDN auth), Google cannot verify the video. Use player_loc with an iframe URL instead.
• Title too long. Anything over 100 characters in <video:title> gets truncated or rejected.
• Missing required field. Often the title or description was empty. The plugin or generator should have caught this, but some auto-generators skip videos with no title.
• Page does not contain the video. The page at <loc> must actually host or embed the video you describe. If you list a video that lives on a different page, Google rejects the entry.

What a video sitemap does not do

Honesty about scope, because this gets oversold. A video sitemap helps Google discover videos and store the metadata. It does not guarantee ranking in Google Video search (that depends on watch time, click-through rate, page quality, and overall site authority). It does not affect normal text-based Google search rankings for the page hosting the video. It does not work for videos that are behind a login or paywall (Google cannot crawl those). And it does not replace good on-page video markup and metadata in the page HTML itself.

How long until videos appear in search

Realistic timeline: 7 to 14 days for the first videos to show up in the Video Indexing Report for most sites. New domains or sites with low crawl frequency can take 3 to 6 weeks. The single biggest accelerator is having your site already verified in Search Console with healthy indexing of regular pages. If your text pages get crawled daily, video sitemap discovery follows the same cadence.

If after 30 days the Video Indexing Report shows zero videos discovered, the most common cause is a sitemap URL that returns HTTP 200 but with a Content-Type header other than application/xml or text/xml. Check the server response headers, not just the body.

The takeaway

A video sitemap is a small XML file that pays back its setup cost the first time Google indexes a video you would otherwise have lost. The five required tags are easy to populate. Submitting to Search Console takes five minutes. The hardest part is generating accurate metadata at scale, which is exactly the problem a dedicated tool solves. Whether you hand-roll the XML, use an SEO plugin, or run a free generator, knowing how to submit a video sitemap to Google Search Console is one of the few SEO tasks where the effort-to-reward ratio is overwhelmingly in your favor.

Generate yours in two minutes with the free Pixellize Video Sitemap Generator, then walk through the 5-step submission above.