Video

If you mark up the content with the VideoObject schema, you can transmit the data to the Yandex.Video service (information about transmitting data to the service).

The advantage of the Schema.org markup is that you can place multiple videos on a single page.

Minimal markup example

For the videos to be indexed, you need to specify the following properties:

Property Type Description
url URL

Link to the video.

name Text

Video title.

description Text

Description of the video.

duration Duration

Video duration.

isFamilyFriendly Boolean

Where the video can be watched by children:

  • true — Appropriate for children.
  • false — Some elements are classified as inappropriate for children by the law or by the site owner.
thumbnail ImageObject

Image description for the preview.

uploadDate Date

Date when the video was uploaded to the site in theISO 8601 format.

Example of a minimal video description

<div itemscope itemtype="http://schema.org/VideoObject" > 
<!--Specification of object type-->
    <a itemprop="url" href="http://mysite.com/view/306/">
    <h1 itemprop="name">What is Schema.org</h1></a>
    <p itemprop="description">Schema.org is the standard for semantic markup of data on the network, announced by Google, Bing and Yahoo! in summer 2011. The purpose of semantic markup is to make the internet more structured and understandable for search engines and special programs that extract and process information in order to better display it in search results.</p>
    <meta itemprop="duration" content="PT6M58S">
    <meta itemprop="isFamilyFriendly" content="true">
    <p>Upload date:<span itemprop="uploadDate">2013-06-05T00:00:00</span></p>
    <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject"> 
    <img itemprop="contentUrl" src="http://mysite.com/images/preview/img1.jpg">
    <meta itemprop="width" content="250">
    <meta itemprop="height" content="120">
    </span>
</div>

Adding a player

Note. At the moment, Yandex.Video search includes embedded players of major hosting sites that have at least 1000 videos in their databases.

For your player to be included in video search results, use one of the following ways to inform the Yandex robot about it:

  • Place the player on a separate page and add a link to this page to the embedUrl element.

    <link itemprop="embedUrl" href="//mysite.com/iframe/yacinema/123/">
  • Wrap the HTML code for embedding your player in the embedHTML tag.

    <div itemprop="embedHTML"><iframe width="640" height="360" src="//mysite.com/123/?feature=player_detailpage" frameborder="0" allowfullscreen=></iframe></div>

After you add the player to the markup, notify us using the . We will test your player and notify you about the results.

Additional markup

The fields listed below aren't required, but they help us to index your videos better and display them for relevant user searches.

    Video format

    The following fields are supported:

    • height — The height of the video.

    • width — The width of the video.

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

    • videoQuality — Quality of video encoding.

      Supported values:

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

      • medium — Average quality (resolution from 360x640 to 720x1280, bitrate from 717 kbps to 1 Mbps).

      • HD — HD quality (resolution from 720x1280 to 1080x1920, bitrate 1-2 Mbps).

      • full HD — 1080p quality (resolution more than 1080×1920, bitrate more than 2 Mbps).

    • contentSize — Video size in kilobytes.

    Video categories

    Video player parameters

    Supported characteristics:

    • embedUrl — Iframe link for embedding the player that plays the video.

    • embedHTML — HTML code for embedding the player that plays the video.

      Specified if it was impossible to form an iframe link for the embedURL field.

    • allowEmbed — 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.

    • playerType — Available codecs for this video format.

      If multiple codecs are available, they are comma-separated.

    • availablePlatform — The platform to use for playing the video.

      Full list of platforms:

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

      • Windows

      • Linux

      • OSX

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

      • iOS

      • Android

      • WindowsPhone

      • WindowsMobile

      • Symbian

      • Bada

      • BlackBerry

      • MeeGo

    Date format

    Dates are specified in the ISO 8601 format.

    Supported characteristics:

    • dateCreated — Date when the video was created.

    • datePublished — Date when the video was first published.

    • dateModified (Date) — Date when changes were made to information about the video on the site.

    • expires (Date) — Date after which the video will no longer be available.

      Used if, for example, rights to view the video are restricted to a time period.

    Example markup:

    <meta itemprop="dateCreated" content="2012-11-08">
    <meta itemprop="datePublished" content="2013-06-05">
    <meta itemprop="dateModified" content="2013-07-22"> 

    Statistics

    Supported characteristics:

    • interactionCount — Counters for specific types of user interaction with a video.

      You can specify the following counter types in the format counterName:number:

      • UserComments — Number of comments.

      • UserLikes — Number of users who liked the video.

      • UserDislikes — Number of users who disliked the video.

      • UserViewsLastMonth — Number of views for the last month.

      • UserViewsLastWeek — Number of views for the last week.

      • UserViewsLastDay — Number of views for the last day.

      • UserViews — Total number of views.

    • aggregateRating — Overall rating, based on collection of user ratings of the video.

      For a generalized rating, the following parameters may be specified:

      • worstRating — The lowest value of the rating (1 by default).

      • bestRating — The highest value of the rating (5 by default).

      • ratingValue — Rating value.

      • ratingCount — Number of user ratings the rating is based on.

    Example markup:

    <meta itemprop="interactionCount" content="UserComments:18" />
    <meta itemprop="interactionCount" content="UserLikes:152" />
    <meta itemprop="interactionCount" content="UserDislikes:3" />
    <meta itemprop="interactionCount" content="UserViewsLastMonth:25550" />
    <meta itemprop="interactionCount" content="UserViewsLastWeek:2544" />
    <meta itemprop="interactionCount" content="UserViewsLastDay:2154" />
    <meta itemprop="interactionCount" content="UserViews:2154587" />
    <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
      <meta itemprop="worstRating" content="1">
      <meta itemprop="bestRating" content="5">
      <meta itemprop="ratingValue" content="5">
      <meta itemprop="ratingCount" content="2545">
    </div>

    Display restriction

    Supported characteristics:

    • allowCountries — List of countries where the video can be viewed, indicating the minimum age of viewers. For example, RU (18+), US (16+), UK (12+).

      This field is useful when there is a certain list of countries that allow showing the video, and the video is not available for all other countries.

    • disallowCountries — List of countries where showing of the video is prohibited or restricted.

      This field is used when the video is allowed for viewing without restrictions in most countries.

      If viewing is restricted, specify the minimum age of viewers. For example, RU (18+), US (16+), UK (12+).

    Paid access to the video

    Supported characteristics:

    • offerType — Type of access to the video.

      By default, the video is considered available free of charge and without registration. To mark the type of access to the video content correctly, include a link to the corresponding XML document in the page code. We recommend using the link tag for this:

      <link itemprop="offerType" href="https://webmaster.yandex.ru/vocabularies/Video/Subscription.xml"/>

      Supported types:

      • Free — The user can access the video without payment and without registration on the site.

      • Buy — The user gets permanent access to view a specific video (purchase).

      • Rent — The user gets access to view a specific video for a restricted period of time (rent).

      • Subscription — The user gets access to the videos of specific series for a certain period of time (subscription).

    • offers — Conditions for getting access to the video.

    • price — Price.

    • priceCurrency — Price currency.

      Specified in the three letter ISO 4217 format (for example, USD).

    • duration — Duration of video subscription or rent.

      Specified in the ISO 8601 format (for example, P1DT12H).

    Properties supported by Yandex.Video

    Note. Properties supported by Yandex but missing in the standard schema are in bold.
    Property Type Description
    Required
    url URL

    Link to the video.

    name Text

    Video title.

    description Text

    Description of the video.

    duration Duration

    Video duration.

    <meta itemprop="duration" content="PT6M58S">
    isFamilyFriendly Boolean

    Where the video can be watched by children:

    • true — Appropriate for children.
    • false — Some elements are classified as inappropriate for children by the law or by the site owner.
    thumbnail ImageObject

    Image description for the preview.

    uploadDate Date

    Date when the video was uploaded to the site in theISO 8601 format.

    Additional Information
    content_id Text

    Video ID, which must be unique for each video.

    The same video published on different pages must have the same ID in the page markup. This way the robot can avoid indexing duplicates.

    author Person

    Login of the user who uploaded the video on the site.

    caption Text

    Video caption.

    contentUrl URL

    URL to access the video clip file.

    feedUrl URL

    URL of the XML feed for this page.

    If the page has an XML feed of the recommended format, you can just specify the object type and the link to the feed using Schema.org.

    However, other fields may be filled in as well. If both XML feed and Schema.org fields are available, the preference is given to the feed. If the feed is unavailable for some reason, the data will be taken from the markup.

    genre Text

    Here you can specify the topic category (humor, sports, music, and so on) and genre (comedy, drama, rock, pop) of the video.

    license Text

    The type of license for distributing the video.

    image URL

    Official image for the video (such as a movie poster or an album cover).

    productionCompany Text or Organization

    Video production company.

    isOfficial Boolean

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

    To show that the video is official, add the isOfficial attribute set to true. If this field is omitted, Yandex will consider the video unofficial.

    status Text or URL

    The current status of the video.

    The following statuses are available:

    • published — The video is published on the site and is public.

    • private — The video is on the site but access to it is restricted.

    • blocked — The video is blocked.

    • processing — The video was uploaded and is being processed.

    • deleted — The video was removed from the site.

    height Distance

    Height of the video.

    width Distance

    Width of the video.

    bitrate Text

    Maximum bitrate in kilobits per second (kbps).

    videoQuality Text

    Quality of video encoding. Supported values:

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

    • medium — Average quality (resolution from 360x640 to 720x1280, bitrate from 717 kbps to 1 Mbps).

    • HD — HD quality (resolution from 720x1280 to 1080x1920, bitrate 1-2 Mbps).

    • full HD — 1080p quality (resolution more than 1080×1920, bitrate more than 2 Mbps).

    contentSize Text

    Size of the video in kilobytes.

    embedUrl URL

    Iframe link for embedding the player to display the video.

    embedHTML Text

    HTML code for embedding the player to display the video. Specified if it was impossible to form an iframe link for the embedURL field.

    allowEmbed Boolean

    Indicates whether the video can be displayed on the Yandex search results page. By default, a video can be played directly in the search results.

    playerType Text

    Available codecs for this video format. If multiple codecs are available, they are comma-separated.

    availablePlatform Text

    The platform that this video can be played on.

    Full list of supported values
    • Desktop — Indicates that the main PC platforms are supported (see the list below).

    • Windows

    • Linux

    • OSX

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

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

    dateCreated Date

    Video creation date.

    datePublished Date

    First publication date.

    dateModified Date

    Date when changes were made to information about the video on the site.

    expires Date

    Date after which the video will no longer be available.

    Used if, for example, rights to view the video are restricted to a time period.

    interactionCount Text

    Counters for specific types of user interaction with a video.

    For details, see the Statistics section.

    aggregateRating AggregateRating

    Overall rating, based on collection of user ratings of the video.

    For details, see the Statistics section.

    allowCountries Text

    List of countries in which this video is available with an indication of the minimum age of viewers. For example, RU (18+), US (16+), UK (12+).

    This field is useful when there is a certain list of countries that allow showing the video, and the video is not available for all other countries.

    disallowCountries Text

    List of countries where showing of the video is prohibited or restricted.

    This field is used when the video is allowed for viewing without restrictions in most countries. If viewing is restricted, specify the minimum age of viewers. For example, RU (18+), US (16+), UK (12+).

    productionCountry Text

    Country of origin.

    Specified in the ISO 3166-1 format.

    inLanguage Text

    Language of the video.

    The language code is specified in the ISO 639 format (for example, EN).

    dubbing Text

    The studio that dubbed the video.

    offers Offer

    Terms for getting access to the video.

    price

    Price.

    priceCurrency Text

    Price currency.

    To specify the price, use the three-letter ISO 4217 format (for example, USD).

    offerType Text or URL

    Type of access to the video.

    By default, the video is considered available free of charge and without registration. To mark the type of access to the video content correctly, include a link to the corresponding XML document in the page code. We recommend using the link tag for this:

    <link itemprop="offerType" href="https://webmaster.yandex.ru/vocabularies/Video/Subscription.xml"/>

    Supported types:

    • Free — The user can access the video without payment and without registration on the site.

    • Buy — The user gets permanent access to view a specific video (purchase).

    • Rent — The user gets access to view a specific video for a restricted period of time (rent).

    • Subscription — The user gets access to the videos of specific series for a certain period of time (subscription).

    duration

    Duration of video subscription or rent. Specified in the ISO 8601 format (for example, P1DT12H).

    Example of a detailed video description

    <div itemscope itemtype="http://schema.org/VideoObject">
    
    <!-- Main characteristics -->
        <link itemprop="url" href="http://mysite.com/view/308/">
        <meta itemprop="name" content="What is schema.org">
        <meta itemprop="description" content="Schema.org is a standard for semantic markup for the internet declared by search engines Google, Bing and Yahoo! in summer 2011.
        The purpose of semantic markup is to make the internet more structured and understandable for search engines and special programs that extract and process information in order to better display it in search results.">
        <meta itemprop="duration" content="PT6M58S">
        <span itemprop="author" itemscope itemtype="http://schema.org/Person"></span>
        <meta itemprop="genre" content="education">
        <link itemprop="feedUrl" href="http://example.com/user111/view24/view24.xml"> 
        <meta itemprop="content_id" content="3543">   
        <meta itemprop="isFamilyFriendly" content="true">
        <meta itemprop="license" content="СС">
        <link itemprop="image" href="http://mysite.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
        <meta itemprop="productionCompany" content="yandex">
        <meta itemprop="status" content="published">
    
    <!-- Dates -->
        <meta itemprop="uploadDate" content="2013-06-05T00:00:00">
        <meta itemprop="dateCreated" content="2012-11-08T00:00:00">
        <meta itemprop="dateModified" content="2013-06-05T00:00:00">
        <meta itemprop="datePublished" content="2013-06-05T00:00:00">    
    
    <!-- Images -->
        <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject">
          <link itemprop="contentUrl" href="http://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
          <meta itemprop="width" content="250">
          <meta itemprop="height" content="120">
        </span>
    
    <!-- Player -->
          <link itemprop="embedUrl" href="//mysite.com/iframe/yacinema/r5cia8fb8q.4708/">
          <div itemprop="embedHTML"><![CDATA[<iframe width="2133" height="1058"                
          src="//mysite.com/iframe/yacinema/123/" frameborder="0" allowfullscreen></iframe>]]></div>
          <meta itemprop="allowEmbed" content="true">
          <meta itemprop="playerType" content="Flash">
          <meta itemprop="width" content="1920">
          <meta itemprop="height" content="1080">
          <meta itemprop="videoQuality" content="full HD">
          <meta itemprop="bitrate" content="526">
          <meta itemprop="contentSize" content="526000">
          <meta itemprop="availablePlatform " content="Mobile">
    
    <!-- Region -->
          <meta itemprop="allowCountries" 
          content="RU (18+), US (16+), UK (12+), TR, AF (18+), AG (11+)">
          <meta itemprop="productionCountry" content="RU"> 
          <meta itemprop="inLanguage" content="RU"> 
          </span>
    
    <!-- Price -->
          <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
            <meta itemprop="price" content="15">
            <meta itemprop="priceCurrency" content="USD">
            <link itemprop="offerType"  
            href="https://webmaster.yandex.ru/vocabularies/Video/Subscription.xml">
            <meta itemprop="duration" content="P1DT12H">
          </span>
    
    <!-- Statistics -->
          <meta itemprop="interactionCount" content="UserComments:18"/>
          <meta itemprop="interactionCount" content="UserLikes:152"/>
          <meta itemprop="interactionCount" content="UserDislikes:3"/>
          <meta itemprop="interactionCount" content="UserViewsLastMonth:25550"/>
          <meta itemprop="interactionCount" content="UserViewsLastWeek:2544"/>
          <meta itemprop="interactionCount" content="UserViewsLastDay:2154"/>
          <meta itemprop="interactionCount" content="UserViews:2154587"/>
          <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
           <meta itemprop="worstRating" content="1">
           <meta itemprop="bestRating" content="5">
           <meta itemprop="ratingValue" content="5">
           <meta itemprop="ratingCount" content="2545">
          </div>
    </div>