Skip to content
All articles

What is a video sitemap, and how does it help video SEO?

guide // , 5 min read, by Darthwares

A video sitemap is an XML file containing metadata about videos hosted on your website pages. It helps Google find and understand video content, especially newly added media or pages standard crawling might miss. Google documents that submitting a sitemap keeps search engines updated and helps eligible videos appear across search results, Video mode, Google Images, and Google Discover.

A diagram showing a website sitemap structure branching into video metadata tags pointing to player URLs and video files.
On this page // 7 sections
  1. 01What is a video sitemap?
  2. 02How does a video sitemap help video search visibility?
  3. 03What tags and technical requirements belong in a video sitemap?
  4. 04How do you structure video metadata and schema markup?
  5. 05How do you diagnose and troubleshoot video sitemap issues?
  6. 06How do you submit and maintain a video sitemap?
  7. 07Common questions

The short version

  • A video sitemap adds extra metadata to an XML sitemap or mRSS feed.
  • Google uses video sitemaps to discover new content and track updates over time.
  • You must include required tags such as player or content URLs and use stable thumbnail URLs.
  • Sitemaps must follow XML rules, including entity-escaping data and keeping files under 50MB.

What is a video sitemap?

A video sitemap is an XML file containing metadata about the videos published across your website pages. Google documents that providing video metadata makes it easier for search engines to find and interpret video content. The Sitemap protocol standard specifies that these files use XML tags to list page URLs alongside media details.

You can implement a video sitemap in several ways depending on your architecture. You can build a separate XML sitemap dedicated to videos, publish an mRSS feed, or add video sitemap tags directly into your existing XML sitemap.

How does a video sitemap help video search visibility?

A video sitemap notifies search engines about video pages so they can index them for search features. Google explains that creating a video sitemap helps locate recently added content or pages that standard crawling mechanisms might not discover. Submitting a sitemap also keeps search engines informed when content changes in the future.

Videos can appear in several places on Google, including main search results, Video mode, Google Images, and Google Discover. To be eligible for features like main search listings, Key Moments, Live Badges, and rich formats, videos must meet indexing requirements. Google recommends creating a dedicated watch page for each video when appropriate for your site.

What tags and technical requirements belong in a video sitemap?

Video sitemaps require specific XML tags and strict technical limits to process correctly. Google states that you must use required tags, including either a content location tag pointing to the raw video file or a player location tag pointing to the video player. You must also supply a single unique and stable thumbnail URL for each video to ensure it can be indexed, and you should avoid listing videos that are unrelated to the host page content.

You can also use optional XML tags to control distribution. For instance, a restriction tag allows or denies a video from appearing in specific countries. According to Sitemaps.org guidelines, all data values in a sitemap must be entity-escaped. Additionally, an individual sitemap file must contain no more than 50,000 URLs and cannot exceed 50MB or 52,428,800 bytes.

How do you structure video metadata and schema markup?

Combining a video sitemap with structured data on watch pages helps search engines parse media details. Google notes that adding video structured data directly to watch pages makes it easier to discover your media assets.

Schema.org defines specifications for video structured data properties. These include player location URLs, upload dates with optional times, and media file byte locations. You can also specify the duration in ISO 8601 format and supply a full text transcript of the audio content.

How do you diagnose and troubleshoot video sitemap issues?

Diagnosing video sitemap issues requires inspecting file structure, XML tags, and thumbnail URLs. Ensuring search engines can read your sitemap involves reviewing technical rules like character escaping, file limits, and required location parameters.

Follow this diagnostic procedure to identify and resolve parsing, discovery, or indexing issues with your video sitemap:

  1. 01Verify that your sitemap location is specified inside your robots.txt file so crawlers can locate it.
  2. 02Check that your sitemap file size remains below 50MB (52,428,800 bytes) and contains 50,000 URLs or fewer.
  3. 03Validate that all data values are entity-escaped and required XML tags, such as content or player location, are present.
  4. 04Confirm that every entry links to relevant host page content and uses a single unique, stable thumbnail URL.
Common video sitemap symptoms and fixes
SymptomDiagnostic checkRequired action
Sitemap file fails parsingCheck for unescaped characters in XML tagsEntity-escape all data values inside the sitemap file
File rejected due to sizeCheck total URL count and file sizeSplit sitemaps to stay under 50,000 URLs and 50MB
Video fails indexing requirementsCheck required XML tags and thumbnail URLsAdd a content or player location tag and a stable thumbnail URL
Search crawler cannot locate sitemapCheck robots.txt rules and directivesDeclare the sitemap URL directly inside the robots.txt file

How do you submit and maintain a video sitemap?

Maintain a video sitemap by updating entries whenever video assets change and referencing the file path in robots.txt. The Sitemap protocol allows specifying your sitemap location directly inside the robots.txt file for automatic discovery.

Google recommends submitting sitemaps to keep search engines informed of ongoing website changes. Depending on your tech stack, you can maintain video tags inside existing sitemaps, publish a separate video sitemap, or maintain an mRSS feed.

Common questions

Can you add video tags to an existing XML sitemap?

Yes. Google documents that you can add video sitemap tags within an existing sitemap, maintain a separate sitemap, or use an mRSS feed.

What size limits apply to video sitemaps?

According to Sitemaps.org, each sitemap file must contain no more than 50,000 URLs and must not exceed 50MB or 52,428,800 bytes.

Is a thumbnail URL required for video indexing?

Yes. Google states that to ensure your videos can be indexed, you must use a single unique and stable thumbnail URL for each video.

How do you restrict video display by country?

Google documents that you can use the video restriction tag inside a video sitemap to allow or deny a video from appearing in specific countries.

Primary sources and further reading

This article was researched and written by an AI model and published automatically. It was written from sentences that were checked to appear on the pages below, but a person has not reviewed the text. If something is wrong, tell us at chibivikramathithan@darthwares.com and we will correct it.