Video Sitemap in 2027: Required Tags, Limits and Mistakes
technical referenceWelcome, my friend. A video sitemap is a file that tells Google where your videos live, which page shows each one, and what they are about. This guide lists the required tags, the optional ones, the limits Google sets, and the mistakes that keep videos out of search.
- required and optional tags
- limits quoted from Google
- deprecated tags flagged
| tag | status | limit |
|---|---|---|
| video:thumbnail_loc | required | image URL |
| video:title | required | match the page |
| video:description | required | 2048 characters |
| content_loc or player_loc | one is required | not the page URL |
| video:duration | optional | 1 to 28800 seconds |
| video:tag | optional | 32 per video |
// a simplified view of Google’s video sitemap tags. The chip colors are my own.
What a Video Sitemap Does for You
It gives Google a clean list of your videos with the page for each one. It helps Google find videos, but it does not guarantee they appear in search.
A sitemap is a file that lists addresses on your site. A video sitemap adds details about each video next to the page that shows it. You can use a separate file, or add video tags to a sitemap you already have. Google also supports mRSS feeds, which are video feeds in a different format, but it recommends video sitemaps.
If sitemaps are new to you, read robots.txt and sitemaps in plain English first. The general file rules live in sitemap XML format rules. Pictures have their own version in the image sitemap guide.
The Watch Page Comes First
Google wants each video on an indexed watch page. A sitemap can’t rescue a video that sits on a page Google won’t index.
Google defines a watch page as a page whose main purpose is to show users a single video. A blog post that reviews an embedded video is not a watch page. A category page that lists several videos is not one either. Each watch page needs a title and description unique to its video, and the video must be embedded on a page that is indexed and performs well in Search. Indexing the page doesn’t guarantee the video is indexed.
So the order of work is simple. First make a proper page for the video. Then list it in the sitemap. A technical SEO check usually finds the page problem before the sitemap problem.
Required and Optional Tags
Four things are required for every video. Everything else is optional, and several old tags are now deprecated.
| Tag | Status | Rule from Google |
|---|---|---|
| video:video | Required | Parent element for one video. Several are allowed per page |
| video:thumbnail_loc | Required | The thumbnail image address |
| video:title | Required | Should match the title on the page |
| video:description | Required | Maximum 2048 characters |
| video:content_loc | One of two | The video file address. Must differ from the page address |
| video:player_loc | One of two | The player address, used for embeds. Must differ from the page address |
| video:duration | Optional | Seconds, from 1 to 28800 (8 hours) |
| video:rating | Optional | A number from 0.0 to 5.0 |
| video:uploader | Optional | Maximum 255 characters |
| video:tag | Optional | Maximum 32 tags per video |
// source: Google Search Central, video sitemaps. Optional tags not shown include view_count, publication_date, expiration_date, family_friendly, restriction, platform, requires_subscription and live.
Google says to include either the video file address or the player address. The file address is the one it recommends. Use the player address for embeds such as a YouTube or Vimeo iframe. Each tag can appear once per video, unless Google says otherwise.
Google has deprecated video:category, video:gallery_loc, video:price and video:tvshow, plus the autoplay and allow_embed attributes of the player tag. If a plugin still outputs them, don’t panic. Just don’t add new ones by hand.
How to Build a Video Sitemap
Seven steps. WordPress video plugins often handle the middle ones, but you should still know what they produce.
- Make a watch page for each video. One main video, a unique title and a unique description.
- Collect the details. You need a thumbnail address, a title, a description, and the file or player address.
- Declare the namespace. Use the video namespace,
http://www.google.com/schemas/sitemap-video/1.1, in the root element. - Write one entry per watch page. Put the watch page address in
<loc>, then one<video:video>block for each video on it. - Escape the text. Google says to escape HTML entities in the title and description, or wrap them in CDATA.
- Make the video fetchable. Google says video URLs can’t be blocked by robots.txt or firewalls, and can’t need a login. Supported protocols are HTTP and FTP.
- Submit and monitor. Use my guide to submit a sitemap to Google, then check the Video indexing report in Search Console.
Is Your Video Ready to List?
Run this check on each video before it goes into the file.
Good Signs
- The page is indexed and has one main video
- The thumbnail has a stable address
- Googlebot can fetch the video file or player
- The title and description match the page
Warning Signs
- The video is a minor extra on an unrelated page
- The file sits behind a login
- The content address equals the page address
- Streaming protocols are the only source
// built from Google’s video sitemap and video SEO pages. Google says not to list videos unrelated to the host page.
Mistakes That Keep Videos Out
These four show up again and again. Each has a plain fix.
Listing the wrong page
A category page with six videos is not a watch page. Create one page per video and list that.
Same address twice
The file or player address must differ from the page address. Point it at the real file or player.
Moving thumbnails
Google’s video guide says frequently changing CDN addresses can prevent indexing. Use stable addresses for thumbnails and files.
Old tags
Price, category and tvshow are deprecated. Remove them and keep the file clean.
Mind the previews too. The max-video-preview robots rule caps how long a video preview can be, and my guide to nosnippet and max-snippet explains how those rules work.
How to Check It Worked
Check the file, then the page, then the Video indexing report.
- Open the sitemap address in a browser and confirm it loads as XML.
- Submit it and read the status in the Sitemaps report.
- Inspect one watch page with the URL Inspection tool. Google says that is how to confirm a script-injected video appears in the rendered HTML.
- Open the Video indexing report. Google says it shows how many indexed watch pages hold an indexed video, and why other videos weren’t indexed.
If a video stays out for reasons you can’t see, an SEO audit will list the causes in one pass. Good technical help from a cheap SEO expert can save weeks of guessing.
Questions People Ask Me
Which video sitemap tags are required?
Thumbnail location, title, description, and either a content location or a player location, all inside a video element. Google says you must include one of the last two.
How long can the description be?
The description is limited to 2048 characters. Google says it should match the on-page description, though not word for word.
Can I put YouTube videos in a video sitemap?
Yes. Google’s page shows embeds using the player location tag with the embed address. The page that holds the embed must still meet the indexing criteria.
Do I need a separate video sitemap?
No. Google says you can use a separate video sitemap or add video tags to an existing sitemap.
Does a video sitemap guarantee video results?
No. Google says it doesn’t guarantee that any video feature will appear. The sitemap helps Google find and understand the video.
Send Me the URL. I’ll Check the Page.
Video problems are usually page problems in disguise. A cheap SEO company that also builds WordPress sites can fix both. One WhatsApp message is enough to start.
Sources and Last Check
- Google Search Central: Video sitemaps (tags, limits, deprecated tags)
- Google Search Central: Video SEO best practices (watch pages, thumbnails, Video indexing report)
- Google Search Central: Build and submit a sitemap (general sitemap rules)
// last checked 11 Nov 2026. The checklist and chip colors are my own.