Video Sitemap: Google's Official Syntax, Required Tags and Alternatives in 2026

A video sitemap is the most direct way to hand Google a list of your videos with their metadata. The rules live in Google's video sitemap and mRSS reference (last updated May 2026), and they have changed more than most guides admit: five tags were dropped, and since December 2023 Google ignores videos that only support a text page. This guide gives the current syntax, says when a video sitemap is worth the effort, compares it with schema markup and mRSS, and lists the reasons videos stay out of the index.

What is a video sitemap?

A video sitemap is a standard XML sitemap extended with video entries. Each url element still points to a page (the watch page), and inside it one video:video block describes each video shown there: thumbnail, title, description, file or player URL, plus optional details such as duration or publication date.

Three facts frame everything else:

• It can live in your existing sitemap. Google accepts video tags inside your main sitemap or in a separate file dedicated to video. A separate file is easier to follow on its own in Search Console.
• It is a discovery and metadata hint. Google states that it does not guarantee every listed video will appear in results. Ranking still depends on the page, the video and the signals covered in our entry on video SEO.
• It works for self-hosted and embedded videos. A YouTube or Vimeo embed is declared with video:player_loc, a file on your server or CDN with video:content_loc.

If you already run an image sitemap, the logic is identical: the page stays the unit, and the media extension adds what Google cannot reliably guess.

What is the official video sitemap syntax?

Here is a minimal, valid file with one watch page and one self-hosted video, following Google's format:

<?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/grilling-steaks.html</loc>
    <video:video>
      <video:thumbnail_loc>https://example.com/thumbs/123.jpg</video:thumbnail_loc>
      <video:title>Grilling steaks for summer</video:title>
      <video:description>Bob shows how to get perfectly done steaks every time.</video:description>
      <video:content_loc>https://cdn.example.com/video/123.mp4</video:content_loc>
      <video:duration>600</video:duration>
      <video:publication_date>2026-05-20T08:00:00+00:00</video:publication_date>
    </video:video>
  </url>
</urlset>

For a YouTube embed, replace video:content_loc with <video:player_loc>https://www.youtube.com/embed/VIDEO_ID</video:player_loc>. Several video:video blocks can sit under the same url, one per video on the page, but Google asks you not to list videos unrelated to the main content of the page.

Required tags

Optional tags still supported

• video:duration: length in seconds, from 1 to 28,800 (8 hours).
• video:publication_date and video:expiration_date: W3C date format; after the expiration date, Google stops showing the video.
• video:restriction and video:platform: allow or deny lists of countries (ISO 3166 codes) or platforms (web, mobile, tv).
• video:family_friendly, video:requires_subscription, video:live: yes or no values.
• video:uploader (255 characters maximum), video:view_count, video:rating (0.0 to 5.0) and video:tag (up to 32 per video).

Tags Google no longer reads

Many generators and older tutorials still output tags that Google removed from its documentation: video:category, video:gallery_loc, video:price, video:tvshow, and the autoplay and allow_embed attributes of video:player_loc. They do not break the file, but they add nothing. Remove them when you clean up a template.

Do you need a video sitemap?

The answer depends less on the file than on the page that hosts the video. In a Search Central blog post of December 4, 2023, Google announced that Video mode would only lead to pages where the video is the main content. Its own examples of pages where the video is supplementary: a blog post where the video complements the text, a product page with a video, and a category page listing several videos of equal prominence.

Google's video SEO best practices (updated December 2025) add that the watch page itself must be indexed and perform well in Search before its video can be considered. A sitemap cannot get around that rule.

Video sitemap, VideoObject schema or mRSS: which one?

Google reads video metadata from three sources: structured data, video sitemaps (or mRSS feeds) and Open Graph tags. Its documentation does not rank one above the others, so the choice is practical.

Google's VideoObject structured data guide (updated September 2026) requires only three properties: name, thumbnailUrl and uploadDate. It recommends contentUrl (preferred over embedUrl), description, duration and hasPart for Clip segments. Key moments need a video of at least 30 seconds, and the LIVE badge needs a BroadcastEvent with isLiveBroadcast set to true. None of this exists in sitemap syntax, which is why the best setup pairs a video sitemap for discovery with schema on each watch page. Our free schema generator builds the JSON-LD, and the structured data validator checks it before you publish. For the wider picture on markup, see our guide to structured data for AI search.

How do you create and submit a video sitemap?

1. List your real watch pages

Start from the pages where the video is the first thing a visitor sees and the reason the page exists. Leave out articles and product pages that only embed a video.

2. Generate the file

Most video hosting platforms and CMS plugins can export a video sitemap; on a custom site, generate it from your database so that titles, thumbnails and durations stay in sync with the pages. A standard sitemap holds up to 50,000 URLs or 50 MB uncompressed; beyond that, split it and use a sitemap index.

3. Check every URL is reachable

Google requires that page, thumbnail and video URLs are not blocked by robots.txt, need no login, are not stopped by a firewall, and use HTTP or FTP (streaming protocols are not supported). A thumbnail blocked by robots.txt even has its own error in the Video indexing report.

4. Submit and reference it

Add the file in the Sitemaps report of Search Console and reference it in robots.txt with a Sitemap: line. Our guide on how to submit a sitemap to Google walks through both, and the sitemap checker catches malformed XML before Google does.

5. Keep it in sync

Update the file when a video is added, replaced or removed, and set video:expiration_date for content with an end date. A sitemap that lists deleted videos wastes crawl and blurs your reports.

Why are videos in my sitemap not indexed?

The Video indexing report in Search Console shows how many indexed pages contain an indexed video, and why the others do not. The most frequent reasons and their fixes:

If the watch page itself is not indexed, fix that first: our guide to Google indexing covers the usual causes.

How does a video sitemap fit into SEO and GEO?

For Google, a clean video sitemap plus VideoObject markup makes each watch page eligible for video results, key moments and the Videos tab. For AI assistants, the picture is different. Sorank's YouTube AI citation study (301,025 AI answers, August 2025 to August 2026) found YouTube cited in 2.35% of measured answers over the last three months, with large gaps between models: 3.69% on Gemini, 0% on Claude. AI assistants mostly quote text, so a watch page earns citations when it carries a written summary or transcript next to the player.

The practical consequence is a split: host your key videos on watch pages you control (sitemap plus schema), publish the same videos on YouTube for reach (see our guide to YouTube marketing), and surround them with articles that answer the questions your buyers ask. That last part is where Sorank helps: it is an SEO and GEO software in autopilot that finds your keywords, groups them into topics with the topical cluster generator, and writes and publishes optimized articles with the blog article generator.

A video sitemap pays off only on true watch pages: list them with the required tags, add VideoObject schema on each page, and keep thumbnails reachable. To build the written content around your videos on autopilot, compare the plans on the pricing page; every plan starts with a 3-day free trial.