Open Graph video markup

Example of minimal markup

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

Property Type Description
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 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).

    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 standard in the YYYY-MM-DDTHH:mm:ss+0:00 format, where:

    • YYYY — year

    • MM — month

    • DD — day

    • HH — hour

    • mm — minute

    • ss — second

    • +0:00 — time zone (in this case — 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 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 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 Type Description
    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 or .

    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 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 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 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 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"/>