Stay organized with collections Save and categorize content based on your preferences.
Video sitemaps and alternativesA video sitemap is a sitemap with additional information about videos hosted on your pages. Creating a video sitemap is a good way to help Google find and understand the video content on your site, especially content that was recently added or that we might not otherwise discover with our usual crawling mechanisms.
Google recommends using video sitemaps, however we also support mRSS feeds.
Video sitemap best practicesVideo sitemaps are based on generic sitemaps, so the general sitemap best practices also apply to video sitemaps. You can create a separate sitemap or mRSS feed just for video, or you can add video sitemap tags within an existing sitemap, whichever is more convenient for you.
Additionally, the following requirements apply to video sitemaps specifically:
If you want to prevent spammers from accessing your video content at the <player_loc> or <content_loc> URLs, verify that any bots accessing your server are really Googlebot.
For more tips about videos in Google Search, see our video best practices.
Example video sitemapThe following example shows a regular sitemap with video extension. It includes two video entries nested in the single <url> tag. The first <video> entry includes all the tags that Google can use while the second only the required tags.
<?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://www.example.com/videos/some_video_landing_page.html</loc>
<video:video>
<video:thumbnail_loc>https://www.example.com/thumbs/123.jpg</video:thumbnail_loc>
<video:title>Grilling steaks for summer</video:title>
<video:description>
Alkis shows you how to get perfectly done steaks every time
</video:description>
<video:content_loc>
http://streamserver.example.com/video123.mp4
</video:content_loc>
<video:player_loc>
https://www.example.com/videoplayer.php?video=123
</video:player_loc>
<video:duration>600</video:duration>
<video:expiration_date>2021-11-05T19:20:30+08:00</video:expiration_date>
<video:rating>4.2</video:rating>
<video:view_count>12345</video:view_count>
<video:publication_date>2007-11-05T19:20:30+08:00</video:publication_date>
<video:family_friendly>yes</video:family_friendly>
<video:restriction relationship="allow">IE GB US CA</video:restriction>
<video:price currency="EUR">1.99</video:price>
<video:requires_subscription>yes</video:requires_subscription>
<video:uploader
info="https://www.example.com/users/grillymcgrillerson">GrillyMcGrillerson
</video:uploader>
<video:live>no</video:live>
</video:video>
<video:video>
<video:thumbnail_loc>https://www.example.com/thumbs/345.jpg</video:thumbnail_loc>
<video:title>Grilling steaks for winter</video:title>
<video:description>
In the freezing cold, Roman shows you how to get perfectly done steaks every time.
</video:description>
<video:content_loc>
http://streamserver.example.com/video345.mp4
</video:content_loc>
<video:player_loc>
https://www.example.com/videoplayer.php?video=345
</video:player_loc>
</video:video>
</url>
</urlset> More examples
The following example demonstrates how to add a Vimeo video embed to a video sitemap:
<?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://www.example.com/videos/some_video_landing_page.html</loc>
<video:video>
<video:thumbnail_loc>https://www.example.com/thumbs/123.jpg</video:thumbnail_loc>
<video:title>Lizzi is painting the wall</video:title>
<video:description>
Gary is watching the paint dry on the wall Lizzi painted.
</video:description>
<video:player_loc>
https://player.vimeo.com/video/987654321
</video:player_loc>
</video:video>
</url>
</urlset>
The following example demonstrates how to add a YouTube video embed to a video sitemap:
<?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://www.example.com/videos/some_video_landing_page.html</loc>
<video:video>
<video:thumbnail_loc>https://www.example.com/thumbs/345.jpg</video:thumbnail_loc>
<video:title>John teaches cheese</video:title>
<video:description>
John explains the differences between a banana and cheese.
</video:description>
<video:player_loc>
https://www.youtube.com/embed/1a2b3c4d
</video:player_loc>
</video:video>
</url>
</urlset> Video sitemap reference
The video tags are defined in the video sitemaps namespace: http://www.google.com/schemas/sitemap-video/1.1. Each tag can only be added one time per video, unless otherwise specified.
To make sure Google can use your video sitemap, you must use the following required tags:
Required tags<video:video>
The parent element for all information about a single video on the page specified by the <loc> tag. You can include multiple <video:video> tags nested in the <loc> tag, one for each video on the hosting page.
<video:thumbnail_loc>
A URL pointing to the video thumbnail image file. Follow the video thumbnail requirements.
<video:title>
The title of the video. All HTML entities must be escaped or wrapped in a CDATA block. We recommend that this match the video title displayed on the web page where the video is embedded.
<video:description>
A description of the video. Maximum 2048 characters. All HTML entities must be escaped or wrapped in a CDATA block. It must match the description displayed on the web page where the video is embedded, but it doesn't need to be a word-for-word match.
<video:content_loc>
A URL pointing to the actual video media file. The file must be one of the supported formats.
It's required to provide either a<video:content_loc> or <video:player_loc> tag. We recommend that your provide the <video:content_loc> tag, if possible. This is the most effective way for Google to fetch your video content files. If <video:content_loc> isn't available, provide <video:player_loc> as an alternative.
Additional guidelines
<loc> tag.VideoObject.contentUrl in structured data.<video:player_loc>
A URL pointing to a player for a specific video. Usually this is the information in the src attribute of an <embed> tag.
<video:content_loc> or <video:player_loc> tag. We recommend that your provide the <video:content_loc> tag, if possible. This is the most effective way for Google to fetch your video content files. If <video:content_loc> isn't available, provide <video:player_loc> as an alternative.
Additional guidelines
<loc> URL.iframe videos, this value is used rather than video:content_loc. This is the equivalent of VideoObject.embedUrl in structured data.Additionally, the following optional tags may help Google better understand your videos and its properties:
Optional tags<video:duration>
The duration of the video, in seconds. Value must be from 1 to 28800 (8 hours).
<video:expiration_date>
The date after which the video is no longer be available, in W3C format. Omit this tag if your video doesn't expire. If present, Google Search won't show your video after this date. For recurring videos at the same URL, update the expiration date to the new expiration date.
Supported values are complete date (YYYY-MM-DD), or complete date plus hours, minutes and seconds, and timezone (YYYY-MM-DDThh:mm:ss+TZD).
Example: 2012-07-16T19:20:30+08:00.
<video:rating>
The rating of the video. Supported values are float numbers in the range 0.0 (low) to 5.0 (high).
<video:view_count>
The number of times the video has been viewed.
<video:publication_date>
The date the video was first published, in W3C format. Supported values are complete date (YYYY-MM-DD) or complete date plus hours, minutes and seconds, and timezone (YYYY-MM-DDThh:mm:ss+TZD).
Example: 2007-07-16T19:20:30+08:00
<video:family_friendly>
Whether the video is available with SafeSearch. If you omit this tag, the video is available when SafeSearch is turned on.
Supported values:
yes: The video is available when SafeSearch is turned on.no: The video is only available when SafeSearch is turned off.<video:restriction>
Whether to show or hide your video in search results from specific countries.
Specify a space-delimited list of country codes in ISO 3166 format. If there's no <video:restriction> tag, Google assumes that the video can be shown in all locations. Note that this tag only affects search results; it doesn't prevent a user from finding or playing your video in a restricted location through other means. Learn more about applying country restrictions.
Attributes:
If the parent tag <video:restriction> is used, the following attribute is required:
relationship: Whether the video is allowed or denied in search results in the specified countries. Supported values are:
allow: The listed countries are allowed and unlisted countries are denied.deny: The listed countries are denied and unlisted countries are allowed.Example: This example allows the video search result to be shown only in Canada and Mexico:
<video:restriction relationship="allow">CA MX</video:restriction>
<video:platform>
Whether to show or hide your video in search results on specified platform types. This is a list of space-delimited platform types. Note that this only affects search results on the specified device types; it doesn't prevent a user from playing your video on a restricted platform.
If there's no <video:platform> tag, Google assumes that the video can be played on all platforms. Learn more about applying platform restrictions.
Supported values:
web: Computer browsers on desktops and laptops.mobile: Mobile browsers, such as those on cellular phones or tablets.tv: TV browsers, such as those available through Google TV devices and game consoles.Attributes:
If the parent tag <video:platform> is used, the following attributes are required:
relationship: Specifies whether the video is restricted or permitted for the specified platforms. Supported values are:
allow: Any omitted platforms will be denied.deny: Any omitted platforms will be allowed.Example: The following example allows users on web or TV, but not mobile devices:<video:platform relationship="allow">web tv</video:platform>
<video:requires_subscription>
Indicates whether a subscription is required to view the video. Supported values are:
yes: Subscription is required.no: Subscription is not required.<video:uploader>
The video uploader's name. The string value can be a maximum of 255 characters.
Attributes:
info [Optional]: Specifies the URL of a web page with additional information about this uploader. This URL must be in the same domain as the <loc> tag.<video:live>
Indicates whether the video is a livestream. Supported values are:
yes: The video is a livestream.no: The video is not a livestream.<video:tag>
An arbitrary string tag describing the video. Tags are generally very short descriptions of key concepts associated with a video or piece of content. A single video could have several tags, although it might belong to only one category. For example, a video about grilling food may belong in the "grilling" category, but could be tagged "steak", "meat", "summer", and "outdoor". Create a new <video:tag> element for each tag associated with a video. A maximum of 32 tags is permitted per video.
We removed the following tags and attributes from our documentation: <video:category>, <video:gallery_loc>, the autoplay and allow_embed attributes of the <video:player_loc> tag, the <video:price> tag and its attributes, and the <video:tvshow> tag and its attributes. See the deprecation announcement for more information.
While Google recommends using video sitemaps, we also support mRSS feeds.
Google supports mRSS, an RSS module that supplements the element capabilities of RSS 2.0. mRSS feeds are very similar to video sitemaps and can be tested, submitted, and updated just like sitemaps.
For more information about media feeds, see the official media RSS documentation.
RSS vs mRSS: mRSS is a RSS extension used for syndicating multimedia files. It allows for a much more detailed description of the content than the RSS standard.Here's an example of an mRSS entry that provides all the tags that Google uses.
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/">
<channel>
<title>Example MRSS</title>
<link>https://www.example.com/examples/mrss/</link>
<description>MRSS Example</description>
<item xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/">
<link>https://www.example.com/examples/mrss/example.html</link>
<media:content url="https://www.example.com/examples/mrss/example.flv" fileSize="405321"
type="video/x-flv" height="240" width="320" duration="120" medium="video" isDefault="true">
<media:player url="https://www.example.com/shows/example/video.swf?flash_params" />
<media:title>Grilling Steaks for Summer</media:title>
<media:description>Get perfectly done steaks every time</media:description>
<media:thumbnail url="https://www.example.com/examples/mrss/example.png" height="120" width="160"/>
<media:price price="19.99" currency="EUR" />
<media:price type="subscription" />
</media:content>
<media:restriction relationship="allow" type="country">us ca</media:restriction>
<dcterms:valid xmlns:dcterms="http://purl.org/dc/terms/">end=2020-10-15T00:00+01:00; scheme=W3C-DTF</dcterms:valid>
<dcterms:type>live-video</dcterms:type>
</item>
</channel>
</rss>
The full mRSS specification contains more optional tags, best practices, and examples.
To make sure Google can use your mRSS feed, you must use the following required tags:
Required tags<media:content>
Encloses information about the video.
Attributes:
medium: Type of content. Set to video.url: The direct URL to the raw video content. If this isn't specified, you must specify the <media:player> tag.duration [Optional but recommended]: Length of the video in seconds.For all of the other optional attributes and child fields of the <media:content> tag, see the mRSS specification.
<media:player>
You must specify at least one of <media:player> or the url attribute in <media:content>.
A URL pointing to a player for a specific video. Usually this is the information in the src attribute of an <embed> tag and must not be the same as the content of the <loc> tag. It can't be the same URL as the <link> tag. The <link> tag points to the URL of the page hosting the video, while this tag points to a player.
<media:title>
The title of the video. Maximum 100 characters. All HTML entities must be escaped or wrapped in a CDATA bock.
<media:description>
The description of the video. Maximum 2048 characters. All HTML entities must be escaped or wrapped in a CDATA block.
<media:thumbnail> A URL pointing to a preview thumbnail. Follow the Video thumbnail requirements.
Additionally, the following optional tags may help Google better understand your videos and its properties:
Optional tags<dcterms:valid>
The publication and expiration date of the video. Here's the Full specification of the dcterms:valid tag.
Example:
<dcterms:valid> start=2002-10-13T09:00+01:00; end=2002-10-17T17:00+01:00; scheme=W3C-DTF <dcterms:valid>
<media:restriction>
A space-delimited list of countries where the video may or may not be played, in ISO 3166 format. If there's no <media:restriction> tag, Google assumes that the video can be played in all countries.
Attributes:
If the parent tag <media:restriction> is used, the following attributes are required:
type: Set the type attribute to country. Only country restrictions are supported.relationship: Specifies whether the video may or may not be played in the specified list of countries. Supported values:
allow: The listed countries are allowed and unlisted countries are denied.deny: The listed countries are denied and unlisted countries are allowed.Learn more about using country restrictions.
Example:
<media:restriction relationship="allow" type="country">us ca</media:restriction>
<media:price>
The price to download or view the video. Don't use this tag for videos that are available without payment. More than one <media:price> element can be listed (for example, in order to specify various currencies or purchasing options).
Attributes:
If the parent tag <media:price> is used, the following attributes are required:
currency: The currency in ISO 4217 format.type: The purchase option. Supported values are:
rent: The video is available for rent.purchase: The video is available for purchase.package: The video is part of a package deal.subscription: The video is available with a subscription.Want to learn more? Check out the following resources:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-04 UTC."],[[["Video sitemaps and mRSS feeds help Google find and index video content on your website, ensuring discoverability in search results."],["Required tags for video sitemaps include `\u003cvideo:thumbnail_loc\u003e`, `\u003cvideo:title\u003e`, `\u003cvideo:description\u003e`, and either `\u003cvideo:content_loc\u003e` or `\u003cvideo:player_loc\u003e` to specify video location."],["mRSS feeds use tags like `\u003cmedia:content\u003e`, `\u003cmedia:player\u003e`, `\u003cmedia:title\u003e`, `\u003cmedia:description\u003e`, and `\u003cmedia:thumbnail\u003e` to provide video information."],["Submit your video sitemap or mRSS feed to Google Search Console to ensure Google is aware of your video content and can index it effectively."],["Optional tags in both video sitemaps and mRSS feeds provide further details about videos, such as duration, restrictions, and ratings, enriching their metadata for better search performance."]]],["Video sitemaps or mRSS feeds help Google discover and index website videos. Sitemaps, extending standard format with video tags, require `\u003cvideo:thumbnail_loc\u003e`, `\u003cvideo:title\u003e`, `\u003cvideo:description\u003e`, and either `\u003cvideo:content_loc\u003e` or `\u003cvideo:player_loc\u003e`. mRSS feeds, an alternative, utilize `\u003cmedia:content\u003e` (with either `url` or `\u003cmedia:player\u003e`), `\u003cmedia:title\u003e`, `\u003cmedia:description\u003e`, and `\u003cmedia:thumbnail\u003e`. Both formats must ensure linked content is accessible to Googlebot. Optional tags include duration, restrictions, and pricing. Properly formatted content and accessibility are crucial.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4