Webmaster
How Yandex indexes sites
A site on search results page

Open Graph video markup

Example of minimal markup

All video markup properties that are processed by the Yandex robot are listed below.

Property TypeDescription
og:title

String

Video title.

Maximum length is 1000 characters; longer text is cut off.

og:url

URL

Canonical path to the page, for example: http://myhost.ru/video.html.

og:video

URL

Path to the video player or file.

og:image

URL

URL of the video preview image.

Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.

og:description

String

Video description.

The recommended length of the video description is 150-1000 characters.

ya:ovs:upload_date

DateTime

Date the video was uploaded, in ISO 8601 format.

ya:ovs:adult

Boolean

Indicates content restricted to viewers age 18+.

To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.

video:duration

Integer

Video length in seconds rounded to the nearest integer.

og:type

String

Video category.

Some categories may require additional fields for the video description.

og:video:type

String

Available codecs for this video format.

Certain data is necessary to correctly index the videoclips. A minimal video description in Open Graph markup might look like this:

<html prefix="og: http://ogp.me/ns#
              video: http://ogp.me/ns/video#
              ya: http://webmaster.yandex.ru/vocabularies/">
             <!--Enter prefixes used-->
<head>
  <meta property="og:title" content="Open Graph for video"/> 
  <meta property="og:url" content="http://mysite.com/view/308/"/> 
  <meta property="og:video" content="//mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="The Open Graph standard was developed by Facebook. It lets you сontrol the preview that is generated when a link is posted on a social networking site and transfers information to other internet services."/> 
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" 
        content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>
</head>

Adding a player

Note. Currently Yandex.Video has embedded players for the major hosting sites (those that have a base of at least 1000 videoclips).

To make sure your player ends up in video search results, let the Yandex robot know about it using one of these methods:

  • Put the player on a separate page and allow the video to play in Yandex search results. Just add the ya:ovs:allow_embed element with the value true.

    <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
    <meta property="ya:ovs:allow_embed" content="true"/>
  • Send the HTML code to integrate your player using the ya:ovs:embed_html element.

    <meta property="ya:ovs:embed_html" content="
    <object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot; type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;>
    <param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
    <param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
    <param value=&quot;high&quot; name=&quot;quality&quot;/>
    <param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/><param value=&quot;true&quot; name=&quot;allowfullscreen&quot;/>
    <param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>

Use the feedback form to let us know when you enter the player information in the markup. We will test the player and inform you of the results.

Additional markup

The fields listed below are not mandatory, but including them will help with indexing your videoclips and will increase the odds that your videos will display in response to a relevant search query.

Video format

The following fields are supported:

  • og:video:width— Video width in pixels.

  • og:video:height — Video height in pixels.

  • ya:ovs:bitrate — Maximum bitrate in kilobits per second (kbps).

  • ya:ovs:quality — Quality of video encoding.

    Supported values:

    • low — Low quality (resolution lower than 360×640, bitrate below 717 kbps)

    • medium — Average quality (resolution between 360×640 and 720×1280, bitrate from 717 kbps to 1 Mbps)

    • HD — HD quality (resolution between 720×1280 and 1080×1920, bitrate of 1-2 Mbps)

    • full HD — 1080 res quality (resolution higher than 1080×1920, bitrate above 2 Mbps).

Video categories

Additional fields that provide further information should be entered for each type of video listed in the og:type field (with the exception of type other).

Movie (video.movie)

If the video.movie value is entered for the og:type element, then the video can be further described using the following fields:

  • ya:ovs:original_name — Name of film in original language.

  • video:release_date— Movie release date.

  • ys:ovs:movie:part — Part number (for movies with multiple parts, such as “Harry Potter and the Deathly Hollows: Part 1”).

Episode of a series (video.episode)

Supported characteristics:

  • ya:ovs:episode (mandatory field) — Episode number.

  • ya:ovs:original_name — Name of film in original language.

  • video:release_date — Series release date.

  • ya:ovs:season — Season number.

Music video (ya:ovs:music)

Supported characteristics:

  • ya:ovs:track_name (mandatory field) — Track name.

  • ya:ovs:album— Album name.

Episode of a show (video.tv_show)

Supported characteristics:

  • ya:ovs:episode (mandatory field) — TV show episode number.

  • video:release_date — Date show was first broadcast.

  • ya:ovs:season — Which season the episode is part of.

Broadcast (ya:ovs:broadcast)

Supported characteristics:

  • ya:ovs:start_date (mandatory field) — Date and time at start of broadcast.

  • ya:ovs:end_date  — Date and time at end of broadcast (don't enter if the video is available at the same address as the last broadcast.)

Video player parameters

Supported characteristics:

  • ya:ovs:allow_embed — Indicates that the video can be displayed on the Yandex search results page.

    <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
    <meta property="ya:ovs:allow_embed" content="true"/>
  • ya:ovs:embed_html — HTML code for embedding video player.

  • og:video:type — Available codecs for this video format.
  • ya:ovs:available_platform — Platforms you can play video on.

    Sample list of supported platforms:

    <meta property="ya:ovs:available_platform" content="Windows"/>
    <meta property="ya:ovs:available_platform" content="WindowsPhone"/>

    Full list of supported values:

    • Desktop — indicates that the main PC platforms are supported (see list below)

    • Windows

    • Linux

    • OSX

    • Mobile — Indicates that the main mobile platforms are supported (listed below).

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

Date format

Date and time should be entered using the ISO 8601 standard in the YYYY-MM-DDTHH:mm:ss+03:00 format, where:

  • YYYY — year

  • MM — month

  • DD — day

  • HH — hour

  • mm — minute

  • ss — second

  • +03:00 — time zone (in this case — Moscow time).

If you want to set just the year (for example, for a movie release date), set it to midnight on January 1 of that year, for example 2001-01-01T00:00:00.

Markup example:

<meta property="ya:ovs:upload_date" content="2013-06-05T06:15:00"/>

Statistics

Viewing and rating statistics for the video can be entered using the following elements:

  • ya:ovs:views_last_day — number of video viewings in the past day.

  • ya:ovs:views_last_month — number of video viewings in the past month.

  • ya:ovs:views_last_week — number of video viewings in the past week.

  • ya:ovs:views_total — total number of video viewings.

  • ya:ovs:comments — total number of video comments.

  • ya:ovs:likes — total number of users who "liked" the video.

  • ya:ovs:dislikes — total number of users who didn't like the video.

  • ya:ovs:rating — average video rating (on a scale from 0 to 10).

Markup example:

<meta property="ya:ovs:views_last_day" content="5"/>
<meta property="ya:ovs:views_last_month" content="555"/>
<meta property="ya:ovs:views_last_week" content="25"/>
<meta property="ya:ovs:views_total" content="78787"/> 
<meta property="ya:ovs:comments" content="23"/> 
<meta property="ya:ovs:likes" content="78782"/> 
<meta property="ya:ovs:dislikes" content="5"/> 
<meta property="ya:ovs:rating" content="9"/> 

Viewing restrictions

Video restrictions are entered using the og:restrictions tag.

International restrictions

You can use the og:restrictions:country:allowed and og:restrictions:country:disallowed elements to enter restrictions regarding where the video can be shown.

  • We recommend using the og:restrictions:country:allowed element if the video is only allowed to be shown in certain countries.

  • We recommend using the og:restrictions:country:disallowed element if the video is only restricted in a few countries. Using these two elements together will cause an error.

Countries should be listed using the ISO 3166-1 format. Multiple restrictions can be comma-separated or set in separate elements.

Age restrictions

Use the og:restrictions:age element to specify any age restriction.

Paid video access

Supported characteristics:

  • ya:ovs:price:rate — Video price (corresponding to payment type).

  • ya:ovs:price — Video payment type.

    Supported values:

    • rent— Access to the videoclip for a given period of time

    • subscription — Subscription to a series of clips, or for longer access period

    • purchase — Purchase of video

    • currency — Currency in ISO 4217 format.

    • duration — duration (length of paid access) in ISO 8601 format.

Properties that Yandex.Video supports

All video markup properties that are processed by the Yandex robot are listed below.

Property TypeDescription
Mandatory
og:title

String

Video title.

Maximum length is 1000 characters; longer text is cut off.

og:url

URL

Canonical path to the page, for example: http://myhost.ru/video.html.

og:video

URL

Path to the video player or file.

og:image

URL

URL of the video preview image.

Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.

og:description

String

Video description.

The recommended length of the video description is from 150 to 1000 characters.

ya:ovs:upload_date

DateTime

Date the video was uploaded, in ISO 8601 format.

ya:ovs:adult

Boolean

Indicates content restricted to viewers age 18+.

To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.

video:duration

Integer

Video length in seconds rounded to the nearest integer.

og:type

String

Video category.

Some categories may require additional fields for the video description.

og:video:type

String

Available codecs for this video format.

Additional
ya:ovs:content_id

String

Video ID, which must be unique for each video.

If the same video is hosted on different pages, it must have the same ID in the markup of those pages. This way the robot can avoid indexing duplicates.

ya:ovs:status

Enum

The current status of the video.

Multiple statuses can be comma-separated or set in multiple <meta> tags.

Supported field values:

  • published

  • blocked

  • private

  • processing

  • deleted

ya:ovs:login

String

Name of the user who uploaded the video.

ya:ovs:is_official

Boolean

Indicates the video is hosted on the official site or channel of the producer, performer, or copyright holder.

To indicate that a video is official, add the is_official element with the value "yes". If the ya:osvs:is_official field is not in the feed, Yandex considers the video unofficial.

ya:ovs:license

Enum

Type of video content license.

Supported values:

  • “cc” — Creative Commons license

  • “commercial” — commercial license

og:restrictions:country:allowed

String

A list of countries where this video is allowed to be shown.

For more details, see Viewing restrictions.

og:restrictions:country:disallowed

String

A list of countries where showing this video is prohibited or restricted.

For more details, see Viewing restrictions.

og:restrictions:age

String

Age restrictions for this video.

For more details, see Viewing restrictions.

ya:ovs:available_platform

Enum

The platform that this video can be played on.

Sample list of supported platforms:

<meta property="ya:ovs:available_platform" content="Windows"/>
<meta property="ya:ovs:available_platform" content="WindowsPhone"/>
Full list of supported values:
  • Desktop — indicates that the main PC platforms are supported (see list below)

  • Windows

  • Linux

  • OSX

  • Mobile — Indicates that the main mobile platforms are supported (listed below).

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo

og:video:width

Integer

Width of the video in pixels.

og:video:height

Integer

Height of the video in pixels.
ya:ovs:bitrate

Integer

Maximum bitrate in kilobits per second (kbps).

ya:ovs:quality

Enum

Quality of video encoding.

Supported values:

  • low — Low quality (resolution lower than 360×640, bitrate below 717 kbps)

  • medium — Average quality (resolution between 360×640 and 720×1280, bitrate from 717 kbps to 1 Mbps)

  • HD — HD quality (resolution between 720×1280 and 1080×1920, bitrate of 1-2 Mbps)

  • full HD — 1080 res quality (resolution higher than 1080×1920, bitrate above 2 Mbps)

ya:ovs:allow_embed

Boolean

Indicates that the video can be displayed on the Yandex search results page.

By default, a video can be played directly in the search results. To restrict the video for viewing only on your site, set the field like this:

<meta property="ya:ovs:allow_embed" content="false"/>
ya:ovs:embed_html

String

HTML code for embedding the player to display the video.

ya:ovs:content_url

URL

URL of the video file.

All video formats are allowed — .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv and so on.

The Yandex robot must be able to access the video file to retrieve and update supplementary information about the video. If you have closed public access to the file, we recommend using reverse DNS lookup to only allow the Yandex robot to have access.

ya:ovs:content_url:public

Boolean

Indicates a public video.

Acceptable values:

  • true — Users can download the video file.

  • false — Only the search robot can download the video file for automated analysis of the video stream.

ya:ovs:category

String

Video category (“music”, “movie”, “series”, and so on).

ya:ovs:genre

String

Video genre in any form (rock, drama, parody).

You can set multiple genres by separating them with commas or putting them in separate genre elements. You can find lists of popular genres in Wikipedia articles on film genre or music genre.

video:tag

String

Keywords (tags) related to the video.

Tags can be comma-separated or set in separate elements.

ya:ovs:languages

String

A list of languages that the video has soundtracks for.

Multiple languages can be comma-separated or set in separate elements. Languages should be set in ISO 639-1 format.

ya:ovs:dubbing

String

Name of the dubbing studio.

ya:ovs:subtitle

URL

Link to the subtitles file for a given language.

ya:ovs:subtitle:language

String

Language of subtitles in ISO 639-1 format.

ya:ovs:price

Enum

Video payment type.

ya:ovs:price:duration

DateTime

Payment duration (length of paid access) in ISO 8601 format.

ya:ovs:price:rate

Integer

Video price (corresponding to payment type in ya:ovs:price field).
ya:ovs:price:currency

String

The currency that the price of the video is specified in (in ISO 4217 format).

ya:ovs:feed_url

URL

Address where current video metadata can be found.

This may be the same as the address of the video's page, if the semantic markup is detailed enough.

ya:ovs:views_last_day

Integer

The number of video viewings in the past day.

ya:ovs:views_last_month

Integer

The number of views of the video over the past month.

ya:ovs:views_last_week

Integer

The number of video viewings in the past week.

ya:ovs:views_total

Integer

Total number of video viewings.

ya:ovs:comments

Integer

Total number of comments on the video.

ya:ovs:likes

Integer

Total number of users who liked the video.

ya:ovs:dislikes

Integer

Total number of users who did not like the video.

ya:ovs:rating

Integer

Average rating of the video (on a scale from 0 to 10).

ya:ovs:person

String

Name of a person who participated in making the video.

ya:ovs:production_company

String

The company that created the video.

ya:ovs:country

String

The country the video was created in.

Multiple countries can be comma-separated or set in separate elements. Countries should be listed using the ISO 3166-1 format.

ya:ovs:poster

URL

Link to an image of the album cover, movie poster, and so on.

Multiple images can be set in multiple poster elements. Minimum image size — 256×360. JPG, PNG and GIF formats are supported.

ya:ovs:created_date

DateTime

Date the video was created, in ISO 8601 format.

ya:ovs:modify_date

DateTime

Date the video was changed, in ISO 8601 format.

ya:ovs:expiration_date

DateTime

Date the right to access video content expires, in ISO 8601 format.

Omit if access rights do not expire.

Example of detailed video description

<!--Mandatory fields-->
<html prefix="og: http://ogp.me/ns#
             video: http://ogp.me/ns/video#
             ya: http://webmaster.yandex.ru/vocabularies/">
 <head>
  ...
  <meta property="og:title" content="What is schema.org"/>
  <meta property="ya:ovs:id" content="3543"/>
  <meta property="og:url" content="http://mysite.com/view/308/"/>
  <meta property="og:description" content="Schema.org is a semantic markup standard for internet data that was released by Google, Bing and Yahoo! during the summer of 2011. "The goals of semantic markup are to make the internet more intelligible and structured, and to make it easier for search systems and special programs to retrieve and process information so that it is clearly presented in search results."/>
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05T00:00:00"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>

<!--Дополнительные поля-->
  <meta property="ya:ovs:status" content="published"/>
  <meta property="ya:ovs:login" content="ivan1"/>
  <meta property="ya:ovs:is_official" content="true"/>
  <meta property="ya:ovs:license" content="cc"/>
  <meta property="og:restrictions:country:allowed" content="Ru, Ua, Us, Uk"/>
  <meta property="ya:ovs:available_platform" content="Desktop"/>
  <meta property="og:video:width" content="350"/>
  <meta property="og:video:height" content="700"/>
  <meta property="ya:ovs:bitrate" content="254"/>
  <meta property="ya:ovs:quality" content="low"/>
  <meta property="ya:ovs:allow_embed" content="true"/>
  <meta property="og:video" content="//mysite.com/iframe/yacinema/123/"/>
  <meta property="ya:ovs:embed_html" content="
   <object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot;  
    type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;/>
   <param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
   <param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
   <param value=&quot;high&quot; name=&quot;quality&quot;/>
   <param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/>
   <param value=&quot;true&quot; name=&quot;allowfullscreen&quot;/>
   <param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>
  <meta property="ya:ovs:content_url" content="http://mysite.com/r5cia8fb8q.4708/111.swf"/>
  <meta property="ya:ovs:content_url:public" content="true"/>
  <meta property="ya:ovs:category" content="education"/>
  <meta property="ya:ovs:genre" content="technology"/>
  <meta property="video:tag" content="technology"/>
  <meta property="video:tag" content="schema.org"/>
  <meta property="ya:ovs:languages" content="ru"/>
  <meta property="ya:ovs:subtitle" content="http://mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:price" content="rent"/>
  <meta property="ya:ovs:price:duration" content="P1DT12H"/>
  <meta property="ya:ovs:price:rate" content="50"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <meta property="ya:ovs:feed_url" content="http://example.com/user111/view24/view24.xml"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <meta property="ya:ovs:views_last_day" content="5"/>
  <meta property="ya:ovs:views_last_month" content="555"/>
  <meta property="ya:ovs:views_last_week" content="25"/>
  <meta property="ya:ovs:views_total" content="78787"/> 
  <meta property="ya:ovs:comments" content="23"/> 
  <meta property="ya:ovs:likes" content="78782"/> 
  <meta property="ya:ovs:dislikes" content="5"/> 
  <meta property="ya:ovs:rating" content="9"/> 
  <meta property="ya:ovs:person" content="Ivan Ivanov"/> 
  <meta property="ya:ovs:production_company" content="yandes"/> 
  <meta property="ya:ovs:country" content="Ru"/> 
  <meta property="ya:ovs:poster" 
   content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/> 
  <meta property="ya:ovs:created_date" content="2012-11-08T00:00:00"/> 
  <meta property="ya:ovs:modify_date" content="2013-06-05T00:00:00"/> 
  <meta property="ya:ovs:expiration_date" content="2023-06-05T00:00:00"/> 
Rate this article
Thank you for your feedback!