Declaring Videos

Videos should be declared within the XML sitemap for each page that they appear on.

<video:video>
    <video:content_loc>http://www.example.com/video123.flv</video:content_loc>
    <video:player_loc allow_embed=“yes” autoplay=“ap=1”>http://www.example.com/videoplayer.swf?video=123</video:player_loc>
    <video:thumbnail_loc>http://www.example.com/thumbs/123.jpg</video:thumbnail_loc>
    <video:title>Grilling steaks</video:title>
    <video:description>Get perfectly done steaks every time</video:description>
</video:video>
Name Description
video:thumbnail_loc (required) The URL of the video thumbnail image file.
Minimum:  160x90px
Maximum: 1920x1080px
Format: jpg, png or gif
video:title (required) The plain text title of the video. Maximum 100 characters.
video:description (required) The plain text description of the video. Maximum 2048 characters.
video:content_loc (maybe) You must specify at least one of <video:player_loc> or <video:content_loc>.
A URL pointing to the actual video file.
video:player_loc (maybe required) You must specify at least one of <video:player_loc> or <video:content_loc> .
A URL pointing to a player for a specific video. Usually this is the information in the src element of an <embed> tag and should not be the same as the content of the <loc> tag. ​
video:duration The duration of the video in seconds. Value must be between 0 and 28800 (8 hours).
video:expiration_date The date after which the video will no longer be available.
video:rating The rating of the video – float numbers in the range 0.0 to 5.0.
video:view_count The number of times the video has been viewed.
Video:publication_date The date the video was first published.
video:family_friendly Yes or No.
video:tag A tag associated with the video.
Tags are generally very short descriptions of key concepts associated with a video or piece of content.
Create a new <video:tag> element for each tag associated with a video. A maximum of 32 tags is permitted.
video:category The video’s category. This should be a string value of no longer than 256 characters.
video:restriction A space-delimited list of countries where the video may or may not be played. Allowed values are country codes in ISO 3166 format. Only one <video:restriction> tag can appear for each video.
The required attribute ‘relationship’ specifies whether the video is restricted or permitted for the specified countries. Allowed values are ‘allow’ or ‘deny’, e.g.

<video:restriction relationship=“allow”>IE GB US CA</video:restriction>
video:gallery_loc A link to the gallery in which this video appears.
video:price The price to download or view the video. Do not use this tag for free videos.The required attribute currency specifies the currency in ISO 4217 format.
The optional attribute ‘type’ specifies the purchase option. Allowed values are ‘rent’ and ‘own’. If this is not specified, the default value is own.
The optional attribute ‘resolution’ specifies the purchased resolution. Allowed values are ‘HD’ and ‘SD’.
More than one <video:price> element can be listed (for example, in order to specify various currencies, purchasing options or resolutions).

Examples:

<video:price currency=“EUR”>1.99</video:price>
<video:price currency=“GBP” type=“rent” resolution=“HD”>1.99</video:price>
video:requires_subscription Indicates whether a subscription (either paid or free) is required to view the video. Allowed values are ‘yes’ or ‘no’.
video:uploader The video uploader’s name.The optional attribute ‘info’ specifies the URL of a webpage with additional information about this uploader. This URL must be on the same domain as the <loc> tag.
video:platform A list of space-delimited platforms where the video may or may not be played.
Allowed values are ‘web’, ‘mobile’ and ‘TV’. Only one <video:platform> tag can appear for each video.
If there is no <video:platform> tag, it is assumed that the video can be played on all platforms.
The required attribute ‘relationship’ specifies whether the video is restricted or permitted for the specified platforms. Allowed values are ‘allow’ or ‘deny’.Example:

<video:platform relationship=“allow”>web mobile</video:platform>
video:live Indicates whether the video is a live stream. ‘Yes’ or ‘no’.