Help Main:   Advanced Features

Submitting a Video Sitemap

It's Hulu's mission to help people find and enjoy the world's premium video content. If your website hosts professionally produced video, you may wish to submit a video sitemap to help us discover your content. Upon submission, we will evaluate adding your content to our search results based on the quality and type of content.


The format of our video sitemap is based on Google's Video Sitemap, with a few additional tags highlighted below. Certain tags, such as "show_name" and "season_number," are especially important in helping users find your videos using Hulu's search tools.


<urlset xmlns=""
<video:player_loc allow_embed="yes" autoplay="ap=1">
<video:title>Grilling steaks for summer</video:title>
<video:description>Get perfectly done steaks every time</video:description>
<video:show_name>The Cooking Loft</video:showname>


Video-specific tag definitions:

<loc> Required The tag specifies the landing page (aka play page, referrer page) for the video. When a user clicks on a video result on a search results page, they will be sent to this landing page. Must be a unique URL.
<video:video> Required  
<video:player_loc> Required At least one of <video:player_loc> and <video:content_loc> is required. A URL pointing to a flash player for a specific video. In general, this is the information in the "src" element of an <embed> tag and should not be the same as the <loc> tag.
The required attribute allow_embed specifies whether we can embed the video in search results. Allowed values are "Yes" or "No".
The optional attribute autoplay has a user-defined string (in the example above, ap=1) that we may append (if appropriate) to the flashvars parameter to enable autoplay of the video. For example: <embed src="" autoplay="ap=1"/>.
Example: Dailymotion:
<video:content_loc> Required At least one of <video:player_loc> and <video:content_loc> is required. This should be a .mpg, .mpeg, .mp4, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv, or other video file format, and can be omitted if <video:player_loc> is specified.
<video:thumbnail_loc> Required A URL pointing to the URL for the video thumbnail image file. We can accept most image sizes/types but recommend your thumbs are at least 160x120 in .jpg, .png, or. gif formats.
<video:title> Required The title of the video. Limited to 100 characters.
<video:description> Required The description of the video. Descriptions longer than 2048 characters will be truncated.
<video:show_name> Optional The show or series name, for example, Family Guy or The Simpsons. Limited to 100 characters.
<video:season_number> Optional The show season number.
<video:episode_number> Optional The video episode number.
<video:video_type> Optional Valid type values include "episode", "clip", "film_trailer", film_clip", "feature_film", and "game".
<video:rating> Optional The rating of the video. The value must be float number in the range 0.0-5.0.
<video:view_count> Optional The number of times the video has been viewed.
<video:publication_date> Optional The date the video was first published, in W3C format. Acceptable values are complete date (YYYY-MM-DD) and complete date plus hours, minutes and seconds (YYYY-MM-DDThh:mm:ss). Fraction and time zone suffixes are optional. For example, 2007-07-16T19:20:30+08:00.
<video:tag> Optional A tag associated with 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.
<video:category> Optional The video's category. For example, cooking. The value should be a string no longer than 256 characters. In general, categories are broad groupings of content by subject. Usually a video will belong to a single category. For example, a site about cooking could have categories for Broiling, Baking, and Grilling.
<video:family_friendly> Optional "No" if the video is rated TV-14, PG-13, TV-MA, R, NC-17, NSFW or NR.
<video:duration> Optional The duration of the video in seconds. Value must be between 0 and 28800 (8 hours). Non-digit characters are disallowed.
<video:expiration_date> Optional The date after which the video will no longer be available, in W3C format. Acceptable values are complete date (YYYY-MM-DD) and complete date plus hours, minutes and seconds (YYYY-MM-DDThh:mm:ss). Fraction and time zone suffixes are optional. For example, 2007-07-16T19:20:30+08:00.


When creating your video sitemap, keep in mind the following:

  • A video sitemap should contain only URLs that refer to video content. Video content includes web pages which embed video, URLs to players for video, or the URLs of raw video content hosted on your site. If we cannot discover video content at the URLs you provide, those records will be ignored.
  • Since each video is uniquely identified by its content URL (the location of the actual video file) or, if a content URL is not present, a player URL (a URL pointing to a player for the video), you must include either the <video:player_loc>or <video:content_loc> tags. If these tags are omitted and we can't find this information, we'll be unable to index your video.
  • Each sitemap file you provide must have no more than 10,000 video items and must be no larger than 10MB uncompressed. An individual video file or thumbnail (specified in the <video:content_loc> and<video:thumbnail_loc> tags, respectively) can be no larger than 30MB. If you have more than 10,000 videos, you can submit multiple sitemaps and a sitemap index file.
  • We can crawl the following video file types: .mpg, .mpeg, .mp4, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv. All files must be accessible via HTTP. Metafiles that require a download of the source via streaming protocols are not supported.
  • The URLs included in the sitemap must have their robots.txt file set appropriately for user-agent "Hulubot".
  • If you have multiple videos embedded on the same html page, use separate <video:video> entries for them with different <video:player_loc> or <video:content_loc> information.
  • Hulu web crawlers will verify that the information you include in the <video:title> and <video:description> fields matches your live site. You should view your play pages in a browser such as Lynx to make sure Hulubot will be able to find them.


The video sitemap that you submit should be fully compatible with Google's Video Sitemap. Hulu web crawlers (user-agent: "Hulubot") will verify and index the contents provided by the sitemap.

Was this information helpful? Yes | No