Open Graph markup for video

Check the markup

To check whether your markup meets our requirements, you can use the validator. Please note that it doesn't check your pages for full compliance with the Open Graph Protocol standard, but only tests whether enough information is available to index your video.

Minimal markup example

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

Property Type Description
og:title

String

Video title.

The maximum length is 1000 characters. Longer text is cut off.

og:url

URL

The canonical page path, for example, https://myhost.ru/video.html.

og:video

URL

The path to the video player or file.

og:image

URL

Video thumbnail URL.

The minimum size is 352×198 pixels.

The recommended size is 564×318 pixels.

The accepted 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

Video upload date in the ISO 8601 format.

ya:ovs:adult

Boolean

An adult content (18+) flag.

Supported values:

  • true: Age limit required.
  • false: No age limit required.
video:duration

Integer

Video duration in seconds, rounded to an integer.

og:type

String

Video category.

Some categories may require additional fields to describe the video.

og:video:type

String

Available codecs for this video format.

Some data is necessary for the video to be indexed correctly. A minimal video description in the Open Graph markup may look like this:

<html prefix="og: http://ogp.me/ns# 
              video: http://ogp.me/ns/video#">

<!--Indicating the prefixes used-->
<head>
  <meta property="og:title" content="Open Graph для видео"/> 
  <meta property="og:url" content="https://www.mysite.com/view/308/"/> 
  <meta property="og:video" content="https://www.mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="Стандарт Open Graph позволяет контролировать превью, которое формируется при публикации ссылки на сайт в социальных сетях, и передавать информацию другим интернет-сервисам."/> 
  <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>

Add a player

Note. The video search currently embeds the players of large hosting companies whose databases contain at least 500 videos.

To add your player to the video search results, place it on a separate page and let us know about the player via the feedback form. We'll test the player and inform you about the results.

If the testing is successful, the player will be added to the page. The videos will be included in Yandex search results. If you don't want your videos to be included in search results, see Prohibit showing videos in search results.

Additional markup

The fields listed below are optional, but you can use them to index your videos better and to show them to users that make relevant queries.

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: Video encoding quality.

    Supported values:

    • low: Low quality (resolution less than 360×640, bitrate lower than 717 kbps).

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

    • HD: HD quality (resolution from 720×1280 to 1080×1920, bitrate 1–2 Mbps).

    • full HD: 1080p quality (resolution greater than 1080×1920, bitrate higher than 2 Mbps).

Video categories

Each video type that's specified in the og:type field (except for the other type) needs additional fields that describe it.

Player parameters

Supported features:

  • ya:ovs:allow_embed: Means that the video can be shown on the Yandex search results page.

    <meta property="og:video" content="https://www.mysite.com/iframe/yacinema/123/"/>
    <meta property="ya:ovs:allow_embed" content="true"/>
  • og:video:type: Available codecs for this video format.
  • ya:ovs:available_platform: The platform that the 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: Means that the main personal computer platforms are supported (listed below)

    • Windows

    • Linux

    • OSX

    • Mobile: Means that the main mobile platforms are supported (listed below)

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

Date format

The date and time must be specified according to 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 specify only the year (for example, the movie release date), set it to midnight, January 1, and the year you want, for example, 2001-01-01T00:00:00.

Markup example:

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

Statistics

The statistics for video views and ratings can be described using the following elements:

  • ya:ovs:views_last_day: The number of video views for the past day.

  • ya:ovs:views_last_month: The number of views for the past month.

  • ya:ovs:views_last_week: The number of views for the past week.

  • ya:ovs:views_total: The total number of video views.

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

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

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

  • ya:ovs:rating: The average video rating (on an integer 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"/> 

Display restrictions

Video display restrictions are set using the og:restrictions tags.

International restrictions

Using the og:restrictions:country:allowed and og:restrictions:country:disallowed elements, you can specify the exact restrictions on displaying a video internationally:

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

  • Use the og:restrictions:country:disallowed element if displaying the video is restricted only in certain countries. Using these two elements together results in an error.

Specify countries in the ISO 3166-1 format. You can separate multiple restrictions with commas or specify them in separate elements.

Age restrictions

Using the og:restrictions:age element, you can specify age restrictions on showing videos.

Properties supported by video search

Video markup properties processed by the Yandex robot are listed below.

Property Type Description
Mandatory
og:title

String

Video title.

The maximum length is 1000 characters. Longer text is cut off.

og:url

URL

The canonical page path, for example, https://myhost.ru/video.html.

og:video

URL

The path to the video player or file.

og:image

URL

Video thumbnail URL.

The minimum size is 352×198 pixels.

The recommended size is 564×318 pixels.

The accepted 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

Video upload date in the ISO 8601 format.

ya:ovs:adult

Boolean

An adult content (18+) flag.

Supported values:

  • true: Age limit required.
  • false: No age limit required.
video:duration

Integer

Video duration in seconds, rounded to an integer.

og:type

String

Video category.

Some categories may require additional fields to describe the video.

og:video:type

String

Available codecs for this video format.

Additional
ya:ovs:content_id

String

The video ID. Must be unique for each video.

The same video that's posted on different pages must have the same ID in the markup of these pages. That way the robot avoids indexing duplicates.

ya:ovs:status

Enum

The video status.

Multiple statuses can be separated by commas or specified in multiple <meta> tags.

Supported field values:

  • published: Published.

  • blocked : Blocked.

  • private: Protected by privacy settings.

  • processing: Being processed.

  • deleted: Deleted.

ya:ovs:login

String

The name of the user who uploaded the video.

ya:ovs:is_official

Boolean

Means that the video is posted on the official site or channel of the manufacturer, performer, or copyright holder.

To indicate that the video is official, set the field to "true". If the ya:ovs:is_official field isn't in the feed, Yandex considers the video unofficial.

ya:ovs:license

Enum

The type of license for the video content.

Supported values:

  • “cc”: A Creative Commons license

  • “commercial”: A commercial license

og:restrictions:country:allowed

String

A list of countries where the video can be shown.

To learn more, see Display restrictions.

og:restrictions:country:disallowed

String

A list of countries where the video is banned or access to it is restricted.

To learn more, see Display restrictions.

og:restrictions:age

String

Age restrictions for the video.

To learn more, see Display restrictions.

ya:ovs:available_platform

Enum

The platform where the video can be played.

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: Means that the main personal computer platforms are supported (listed below)

  • Windows

  • Linux

  • OSX

  • Mobile: This means that the main mobile platforms are supported (listed below).

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo

og:video:width

Integer

The video width in pixels.

og:video:height

Integer

The video height in pixels.
ya:ovs:bitrate

Integer

Maximum bitrate in kilobits per second (kbps).

ya:ovs:quality

Enum

Video encoding quality.

Supported values:

  • low: Low quality (resolution less than 360×640, bitrate lower than 717 kbps).

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

  • HD: HD quality (resolution from 720×1280 to 1080×1920, bitrate 1–2 Mbps).

  • full HD: 1080p quality (resolution greater than 1080×1920, bitrate higher than 2 Mbps).

ya:ovs:allow_embed

Boolean

Means that the video can be shown on the Yandex search results page.

By default, videos can be played directly in the search results. To make the video available on your site only, set the field like this:

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

URL

The video file URL.

Any video formats are allowed: MPG, MPEG, MP4, M4V, MOV, WMV, ASF, AVI, RA, RAM, RM, FLV, and other formats.

The Yandex robot needs access to the video file to extract and update additional video information. If you ban public access to the file, we recommend using a reverse DNS query to allow only the Yandex robot to download it.

ya:ovs:content_url:public

Boolean

Means that the video is publicly available.

Acceptable values:

  • true: Users can download the video.

  • false: Only a search robot can download the video file for automated video stream analysis.

ya:ovs:category

String

Video category (for example, “music”, “movie”, or “TV show”).

ya:ovs:genre

String

Video genre, in free format (for example: rock, drama, parody).

You can specify multiple genres separated by commas or in separate genre elements. You can find lists of popular genres in Wikipedia articles about feature movie genres and music genres.

video:tag

String

Keywords (tags) that describe the video.

You can divide tags by commas or enter them in separate elements.

ya:ovs:languages

String

A list of languages for which audio tracks are available in the video.

You can separate multiple languages by commas or specify them in separate elements. Languages must be specified in the ISO 639-1 format.

ya:ovs:dubbing

String

The name of the dubbing studio.

ya:ovs:subtitle

URL

A link to a subtitle file in a specific language.

ya:ovs:subtitle:language

String

Subtitle language in the ISO 639-1 format.

ya:ovs:feed_url

URL

The address where you can get up-to-date video metadata.

It can match the address of the video page if the semantic markup is detailed enough.

ya:ovs:views_last_day

Integer

The number of video views for the past day.

ya:ovs:views_last_month

Integer

The number of views in the past month.

ya:ovs:views_last_week

Integer

The number of video views in the past week.

ya:ovs:views_total

Integer

The total number of video views.

ya:ovs:comments

Integer

The total number of video comments.

ya:ovs:likes

Integer

The total number of users who liked the video.

ya:ovs:dislikes

Integer

The total number of users who disliked the video.

ya:ovs:rating

Integer

The average video rating (on an integer scale from 0 to 10).

ya:ovs:person

String

The name of a person who took part in making the video.

ya:ovs:person:role

String

The video participant and their role in the creation of the video.

Indicate who this person is; for example, an actor, director, producer, or performer.

List of supported professions
  • Writer

  • Actor

  • Voice actor

  • Arranger

  • Drummer

  • Bass guitarist

  • Host

  • Singer

  • Movie director

  • Casting director

  • Conductor

  • Double

  • Sound operator

  • Sound engineer

  • Acoustic guitar player

  • Electric guitar player

  • Stunt person

  • Keyboard player

  • Composer

  • Consultant

  • Wardrobe manager

  • Operator

  • Director of photography

  • Lighting technician

  • Hairdresser

  • Assistant director

  • Stunt director

  • Producer

  • Editor

  • Editing director

  • Production director

  • Rhythm guitarist

  • Violinist

  • Screenwriter

  • Production designer

  • Costume designer

ya:ovs:production_company

String

The company that created the video.

ya:ovs:country

String

The country where the video was created.

You can separate multiple countries by commas or specify them in separate elements. Specify countries in the ISO 3166-1 format.

ya:ovs:poster

URL

Link to the album cover, movie poster, or another related image.

You can specify multiple images in separate poster elements. The minimum image size is 256×360. JPG, PNG, and GIF formats are supported.

ya:ovs:created_date

DateTime

Video creation date in the ISO 8601 format.

ya:ovs:modify_date

DateTime

The date when the video was changed in the ISO 8601 format.

ya:ovs:expiration_date

DateTime

The date when the rights to the video content expire in the ISO 8601 format.

This isn't specified if the rights to the video don't have an expiration date.

Example of a detailed video description

<!--Required fields-->
<html prefix="og: http://ogp.me/ns#
              video: http://ogp.me/ns/video#">
 <head>
  ...
  <meta property="og:title" content="Что такое schema.org"/>
  <meta property="ya:ovs:content_id" content="3543"/>
  <meta property="og:url" content="https://www.mysite.com/view/308/"/>
  <meta property="og:description" content="Schema.org is a semantic data markup standard that was set by the search engines Google, Bing, and Yahoo! in the summer of 2011. The purpose of semantic markup is to make the internet more understandable and structured and to make it easier for search engines and special programs to extract and process information for its convenient presentation 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"/>

<!--Additional fields-->
  <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="https://www.mysite.com/iframe/yacinema/123/"/>
  
  <meta property="ya:ovs:content_url" content="https://www.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="https://www.mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:feed_url" content="https://example.com/user111/view24/view24.xml"/>
  <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="Иван Иванов"/> 
  <meta property="ya:ovs:person:role" content="director"/>
  <meta property="ya:ovs:person" content="Иван Петров"/> 
  <meta property="ya:ovs:person:role" content="host"/>
  <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"/>