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 | Video title. Maximum length is 1000 characters; longer text is cut off. | |
og:url | Canonical path to the page, for example: https://myhost.ru/video.html. | |
og:video | Path to the video player or file. | |
og:image | URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF. | |
og:description | Video description. The recommended length of the video description is 150-1000 characters. | |
ya:ovs:upload_date | Date the video was uploaded, in ISO 8601 format. | |
ya:ovs:adult | 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 | Video length in seconds rounded to the nearest integer. | |
og:type | Some categories may require additional fields for the video description. | |
og:video:type | Available codecs for this video format. |
Property | Type | Description |
---|---|---|
og:title | Video title. Maximum length is 1000 characters; longer text is cut off. | |
og:url | Canonical path to the page, for example: https://myhost.ru/video.html. | |
og:video | Path to the video player or file. | |
og:image | URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF. | |
og:description | Video description. The recommended length of the video description is 150-1000 characters. | |
ya:ovs:upload_date | Date the video was uploaded, in ISO 8601 format. | |
ya:ovs:adult | 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 | Video length in seconds rounded to the nearest integer. | |
og:type | Some categories may require additional fields for the video description. | |
og:video:type | 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#">
<!--Enter prefixes used-->
<head>
<meta property="og:title" content="Open Graph for video"/>
<meta property="og:url" href="https://www.mysite.com/view/308/"/>
<meta property="og:video" href="https://www.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" href="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
To make sure your player ends up in video search results, let the Yandex robot know about it:
- Put the player on a separate page.
- Allow the video to play in Yandex search results. Just add the
ya:ovs:allow_embed
element with the valuetrue
.<meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/> <meta property="ya:ovs:allow_embed" content="true"/>
- 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
).
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”).
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.
Supported characteristics:
ya:ovs:track_name
(mandatory field) — Track name.ya:ovs:album
— Album name.
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.
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:video" href="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
— 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"/>
Desktop — indicates that the main PC platforms are supported (listed below)
Windows
Linux
OSX
Mobile — Indicates that the main mobile platforms are supported (listed below)
iOS
Android
WindowsPhone
WindowsMobile
Symbian
Bada
BlackBerry
MeeGo
Full list of supported values
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.
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 | Video title. Maximum length is 1000 characters; longer text is cut off. | |
og:url | Canonical path to the page, for example: https://myhost.ru/video.html. | |
og:video | Path to the video player or file. | |
og:image | URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF. | |
og:description | Video description. The recommended length of the video description is from 150 to 1000 characters. | |
ya:ovs:upload_date | Date the video was uploaded, in ISO 8601 format. | |
ya:ovs:adult | 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 | Video length in seconds rounded to the nearest integer. | |
og:type | Some categories may require additional fields for the video description. | |
og:video:type | Available codecs for this video format. | |
Additional | ||
ya:ovs:content_id | 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 | The current status of the video. Multiple statuses can be comma-separated or set in multiple Supported field values:
| |
ya:ovs:login | Name of the user who uploaded the video. | |
ya:ovs:is_official | 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:ovs:license | Type of video content license. Supported values:
| |
og:restrictions:country:allowed | A list of countries where this video is allowed to be shown. For more details, see Viewing restrictions. | |
og:restrictions:country:disallowed | A list of countries where showing this video is prohibited or restricted. For more details, see Viewing restrictions. | |
og:restrictions:age | Age restrictions for this video. For more details, see Viewing restrictions. | |
ya:ovs:available_platform | The platform that this video can be played on. Sample list of supported platforms:
Full list of supported values: | |
og:video:width | Width of the video in pixels. | |
og:video:height | Height of the video in pixels. | |
ya:ovs:bitrate | Maximum bitrate in kilobits per second (kbps). | |
ya:ovs:quality | Quality of video encoding. Supported values:
| |
ya:ovs:allow_embed | 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: | |
ya:ovs:content_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 | Indicates a public video. Acceptable values:
| |
ya:ovs:category | Video category (“music”, “movie”, “series”, and so on). | |
ya:ovs:genre | Video genre in any form (rock, drama, parody). You can set multiple genres by separating them with commas or putting them in separate | |
video:tag | Keywords (tags) related to the video. Tags can be comma-separated or set in separate elements. | |
ya:ovs:languages | 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 | Name of the dubbing studio. | |
ya:ovs:subtitle | Link to the subtitles file for a given language. | |
ya:ovs:subtitle:language | Language of subtitles in ISO 639-1 format. | |
ya:ovs:feed_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 | The number of video viewings in the past day. | |
ya:ovs:views_last_month | The number of views of the video over the past month. | |
ya:ovs:views_last_week | The number of video viewings in the past week. | |
ya:ovs:views_total | Total number of video viewings. | |
ya:ovs:comments | Total number of comments on the video. | |
ya:ovs:likes | Total number of users who liked the video. | |
ya:ovs:dislikes | Total number of users who did not like the video. | |
ya:ovs:rating | Average rating of the video (on a scale from 0 to 10). | |
ya:ovs:person | Name of a person who participated in making the video. | |
ya:ovs:production_company | The company that created the video. | |
ya:ovs:country | 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 | 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 | Date the video was created, in ISO 8601 format. | |
ya:ovs:modify_date | Date the video was changed, in ISO 8601 format. | |
ya:ovs:expiration_date | Date the right to access video content expires, in ISO 8601 format. Omit if access rights do not expire. |
Property | Type | Description |
---|---|---|
Mandatory | ||
og:title | Video title. Maximum length is 1000 characters; longer text is cut off. | |
og:url | Canonical path to the page, for example: https://myhost.ru/video.html. | |
og:video | Path to the video player or file. | |
og:image | URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF. | |
og:description | Video description. The recommended length of the video description is from 150 to 1000 characters. | |
ya:ovs:upload_date | Date the video was uploaded, in ISO 8601 format. | |
ya:ovs:adult | 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 | Video length in seconds rounded to the nearest integer. | |
og:type | Some categories may require additional fields for the video description. | |
og:video:type | Available codecs for this video format. | |
Additional | ||
ya:ovs:content_id | 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 | The current status of the video. Multiple statuses can be comma-separated or set in multiple Supported field values:
| |
ya:ovs:login | Name of the user who uploaded the video. | |
ya:ovs:is_official | 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:ovs:license | Type of video content license. Supported values:
| |
og:restrictions:country:allowed | A list of countries where this video is allowed to be shown. For more details, see Viewing restrictions. | |
og:restrictions:country:disallowed | A list of countries where showing this video is prohibited or restricted. For more details, see Viewing restrictions. | |
og:restrictions:age | Age restrictions for this video. For more details, see Viewing restrictions. | |
ya:ovs:available_platform | The platform that this video can be played on. Sample list of supported platforms:
Full list of supported values: | |
og:video:width | Width of the video in pixels. | |
og:video:height | Height of the video in pixels. | |
ya:ovs:bitrate | Maximum bitrate in kilobits per second (kbps). | |
ya:ovs:quality | Quality of video encoding. Supported values:
| |
ya:ovs:allow_embed | 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: | |
ya:ovs:content_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 | Indicates a public video. Acceptable values:
| |
ya:ovs:category | Video category (“music”, “movie”, “series”, and so on). | |
ya:ovs:genre | Video genre in any form (rock, drama, parody). You can set multiple genres by separating them with commas or putting them in separate | |
video:tag | Keywords (tags) related to the video. Tags can be comma-separated or set in separate elements. | |
ya:ovs:languages | 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 | Name of the dubbing studio. | |
ya:ovs:subtitle | Link to the subtitles file for a given language. | |
ya:ovs:subtitle:language | Language of subtitles in ISO 639-1 format. | |
ya:ovs:feed_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 | The number of video viewings in the past day. | |
ya:ovs:views_last_month | The number of views of the video over the past month. | |
ya:ovs:views_last_week | The number of video viewings in the past week. | |
ya:ovs:views_total | Total number of video viewings. | |
ya:ovs:comments | Total number of comments on the video. | |
ya:ovs:likes | Total number of users who liked the video. | |
ya:ovs:dislikes | Total number of users who did not like the video. | |
ya:ovs:rating | Average rating of the video (on a scale from 0 to 10). | |
ya:ovs:person | Name of a person who participated in making the video. | |
ya:ovs:production_company | The company that created the video. | |
ya:ovs:country | 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 | 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 | Date the video was created, in ISO 8601 format. | |
ya:ovs:modify_date | Date the video was changed, in ISO 8601 format. | |
ya:ovs:expiration_date | 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#">
<head>
...
<meta property="og:title" content="What is schema.org"/>
<meta property="ya:ovs:id" content="3543"/>
<meta property="og:url" href="https://www.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" href="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" href="https://www.mysite.com/iframe/yacinema/123/"/>
<meta property="ya:ovs:content_url" href="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" href="https://www.mysite.com/r5cia8fb8q.4708/sdf.str"/>
<meta property="ya:ovs:subtitle:language" content="ru"/>
<meta property="ya:ovs:feed_url" href="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="Ivan Ivanov"/>
<meta property="ya:ovs:production_company" content="yandes"/>
<meta property="ya:ovs:country" content="Ru"/>
<meta property="ya:ovs:poster" href="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"/>