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 | Video title. The maximum length is 1000 characters. Longer text is cut off. | |
og:url | The canonical page path, for example, https://myhost.ru/video.html. | |
og:video | The path to the video player or file. | |
og:image | 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 | Video description. The recommended length of the video description is 150–1000 characters. | |
ya:ovs:upload_date | Video upload date in the ISO 8601 format. | |
ya:ovs:adult | A sign of content with an 18+ age limit. To mark an adult video, specify “true”. If an age limit isn't required, specify “false”. | |
video:duration | Video duration in seconds, rounded to an integer. | |
og:type | Some categories may require additional fields to describe the video. | |
og:video:type | Available codecs for this video format. |
Property | Type | Description |
---|---|---|
og:title | Video title. The maximum length is 1000 characters. Longer text is cut off. | |
og:url | The canonical page path, for example, https://myhost.ru/video.html. | |
og:video | The path to the video player or file. | |
og:image | 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 | Video description. The recommended length of the video description is 150–1000 characters. | |
ya:ovs:upload_date | Video upload date in the ISO 8601 format. | |
ya:ovs:adult | A sign of content with an 18+ age limit. To mark an adult video, specify “true”. If an age limit isn't required, specify “false”. | |
video:duration | Video duration in seconds, rounded to an integer. | |
og:type | Some categories may require additional fields to describe the video. | |
og:video:type | 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#">
<!--An indication of 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="The Open Graph standard was developed by Facebook. You can use it to control the preview that's formed when a site link is published on social networks and to send 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>
Add a player
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.
If the og:type element has the video.movie
value specified, the video can be further described using the following fields:
ya:ovs:original_name
: The movie name in its original language.video:release_date
: The movie release date.ys:ovs:movie:part
: The part number (for movies that have several parts, for example, “Harry Potter and the Deathly Hallows: Part 1”).
Supported features:
ya:ovs:episode
(required field): The episode number.ya:ovs:original_name
: The episode title in its original language.video:release_date
: The date the episode aired.ya:ovs:season
: The number of the season thar the episode belongs to.
Supported features:
ya:ovs:track_name
(required field): The track name.ya:ovs:album
: The name of the album that the track is included in.
Supported features:
ya:ovs:episode
(required field): The show episode number.video:release_date
: The date that the episode of the show aired.ya:ovs:season
: The number of the season that the episode belongs to.
Supported features:
ya:ovs:start_date
(required field): The broadcast start date and time.ya:ovs:end_date
: The broadcast end date and time (not specified if the recording is available at the same address when the broadcast ends).
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"/>
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
Full list of supported values
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
andog: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 | Video title. The maximum length is 1000 characters. Longer text is cut off. | |
og:url | The canonical page path, for example, https://myhost.ru/video.html. | |
og:video | The path to the video player or file. | |
og:image | 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 | Video description. The recommended length of the video description is 150–1000 characters. | |
ya:ovs:upload_date | Video upload date in the ISO 8601 format. | |
ya:ovs:adult | A sign of content with an 18+ age limit. To mark an adult video, specify “true”. If an age limit isn't required, specify “false”. | |
video:duration | Video duration in seconds, rounded to an integer. | |
og:type | Some categories may require additional fields to describe the video. | |
og:video:type | Available codecs for this video format. | |
Additional | ||
ya:ovs:content_id | 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 | The video status. Multiple statuses can be separated by commas or specified in multiple Supported field values:
| |
ya:ovs:login | The name of the user who uploaded the video. | |
ya:ovs:is_official | 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:license | The type of license for the video content. Supported values:
| |
og:restrictions:country:allowed | A list of countries where the video can be shown. To learn more, see Display restrictions. | |
og:restrictions:country:disallowed | A list of countries where the video is banned or access to it is restricted. To learn more, see Display restrictions. | |
og:restrictions:age | Age restrictions for the video. To learn more, see Display restrictions. | |
ya:ovs:available_platform | The platform where the video can be played. Sample list of supported platforms:
Full list of supported values | |
og:video:width | The video width in pixels. | |
og:video:height | The video height in pixels. | |
ya:ovs:bitrate | Maximum bitrate in kilobits per second (kbps). | |
ya:ovs:quality | Video encoding quality. Supported values:
| |
ya:ovs:allow_embed | 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: | |
ya:ovs:content_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 | Means that the video is publicly available. Acceptable values:
| |
ya:ovs:category | Video category (for example, “music”, “movie”, or “TV show”). | |
ya:ovs:genre | Video genre, in free format (for example: rock, drama, parody). You can specify multiple genres separated by commas or in separate | |
video:tag | Keywords (tags) that describe the video. You can divide tags by commas or enter them in separate elements. | |
ya:ovs:languages | 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 | The name of the dubbing studio. | |
ya:ovs:subtitle | A link to a subtitle file in a specific language. | |
ya:ovs:subtitle:language | Subtitle language in the ISO 639-1 format. | |
ya:ovs:feed_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 | The number of video views for the past day. | |
ya:ovs:views_last_month | The number of views in the past month. | |
ya:ovs:views_last_week | The number of video views in 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 disliked the video. | |
ya:ovs:rating | The average video rating (on an integer scale from 0 to 10). | |
ya:ovs:person | The name of a person who took part in making the video. | |
ya:ovs:person:role | 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 | |
ya:ovs:production_company | The company that created the video. | |
ya:ovs:country | 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 | 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 | Video creation date in the ISO 8601 format. | |
ya:ovs:modify_date | The date when the video was changed in the ISO 8601 format. | |
ya:ovs:expiration_date | 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. |
Property | Type | Description |
---|---|---|
Mandatory | ||
og:title | Video title. The maximum length is 1000 characters. Longer text is cut off. | |
og:url | The canonical page path, for example, https://myhost.ru/video.html. | |
og:video | The path to the video player or file. | |
og:image | 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 | Video description. The recommended length of the video description is 150–1000 characters. | |
ya:ovs:upload_date | Video upload date in the ISO 8601 format. | |
ya:ovs:adult | A sign of content with an 18+ age limit. To mark an adult video, specify “true”. If an age limit isn't required, specify “false”. | |
video:duration | Video duration in seconds, rounded to an integer. | |
og:type | Some categories may require additional fields to describe the video. | |
og:video:type | Available codecs for this video format. | |
Additional | ||
ya:ovs:content_id | 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 | The video status. Multiple statuses can be separated by commas or specified in multiple Supported field values:
| |
ya:ovs:login | The name of the user who uploaded the video. | |
ya:ovs:is_official | 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:license | The type of license for the video content. Supported values:
| |
og:restrictions:country:allowed | A list of countries where the video can be shown. To learn more, see Display restrictions. | |
og:restrictions:country:disallowed | A list of countries where the video is banned or access to it is restricted. To learn more, see Display restrictions. | |
og:restrictions:age | Age restrictions for the video. To learn more, see Display restrictions. | |
ya:ovs:available_platform | The platform where the video can be played. Sample list of supported platforms:
Full list of supported values | |
og:video:width | The video width in pixels. | |
og:video:height | The video height in pixels. | |
ya:ovs:bitrate | Maximum bitrate in kilobits per second (kbps). | |
ya:ovs:quality | Video encoding quality. Supported values:
| |
ya:ovs:allow_embed | 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: | |
ya:ovs:content_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 | Means that the video is publicly available. Acceptable values:
| |
ya:ovs:category | Video category (for example, “music”, “movie”, or “TV show”). | |
ya:ovs:genre | Video genre, in free format (for example: rock, drama, parody). You can specify multiple genres separated by commas or in separate | |
video:tag | Keywords (tags) that describe the video. You can divide tags by commas or enter them in separate elements. | |
ya:ovs:languages | 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 | The name of the dubbing studio. | |
ya:ovs:subtitle | A link to a subtitle file in a specific language. | |
ya:ovs:subtitle:language | Subtitle language in the ISO 639-1 format. | |
ya:ovs:feed_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 | The number of video views for the past day. | |
ya:ovs:views_last_month | The number of views in the past month. | |
ya:ovs:views_last_week | The number of video views in 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 disliked the video. | |
ya:ovs:rating | The average video rating (on an integer scale from 0 to 10). | |
ya:ovs:person | The name of a person who took part in making the video. | |
ya:ovs:person:role | 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 | |
ya:ovs:production_company | The company that created the video. | |
ya:ovs:country | 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 | 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 | Video creation date in the ISO 8601 format. | |
ya:ovs:modify_date | The date when the video was changed in the ISO 8601 format. | |
ya:ovs:expiration_date | 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: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"/>