Player requirements

Follow the requirements below to ensure that your player is displayed in the video search results correctly.

When video search results are generated, both player availability in the search and the user's experience of interaction with the player are taken into account. Because of this, if your videos are easy to view in the search results, they're more likely to be displayed when the user enters a relevant query. Videos don't appear in the search results without correct player settings.
  1. Mandatory requirements for the player to appear in the search results
  2. Mandatory requirements for the player in mobile search
  3. Mandatory requirements for the player to appear in the TV app
  4. Additional requirements

Mandatory requirements for the player to appear in the search results

  • Add the video player to the markup

    For your player to appear in the video search results, the Yandex robot must index it. For this, you need to put the link to the player in your markup and let us know about it.

    To learn more, go to Schema.org markup and Open Graph markup.

  • Support HTTPS for the player

    When a player is added, data exchange security is thoroughly checked. Video search uses the secure HTTPS protocol. For the player to be displayed in the search results, it's embedded on HTTPS video search pages. Because of this, the player and all external scripts and images (for example, ad modules and web analytics tags) must be accessible via HTTPS. Otherwise, browsers automatically block player download and playback, and execution of other embedded scenarios (for example, playing ads) on encrypted video search pages.

    To learn more, go to HTTPS support.

  • Remove intrusive ads

    When sites are ranked, preference is given to resources that don't use intrusive ads.

    To learn more about ad requirements, go to Ads in videos.

  • Allow content playback for video search
    When the player is embedded, content playback must be allowed. You can check which site your player is embedded on by the Referer header from the browser. If you prohibit embedding content on third-party sites, but you want it to be displayed on the video search page, you need to allow embedding for yandex.com and yastatic.net:
    Referer: https://yastatic.net/

Mandatory requirements for the player in mobile search

  • Use an HTML5 player

    To appear in mobile video search results, use an HTML5 player. This way, you can reach an audience of mobile device users and improve the quality of mobile search for your videos.

    To learn more, go to Mobile player.

Mandatory requirements for the player to appear in the TV app

  • Use an HTML5 player

    Support HTML5 so that the player appears in the video search app for Smart TV devices. The adapted app layout and convenient player controls allow your video content to be displayed on TVs in better quality.

  • Transmit video status events

    To display the player in the video search app for TVs and correctly play videos on devices that support Smart TV, you need to transmit video status data and information about player errors.

    To learn more, see Transmit data about video status.

  • Submit an application for adding a player

    Fill out the application. We'll consider adding your player and let you know about the results.

Additional requirements

Additional requirements are taken into account by video search algorithms and affect the quality of the site's video search. Following the requirements increases user confidence in the site's player and improves user experience of watching your videos.

  • Ensure that the player works correctly on dynamic pages

    All player elements (for example, elements on the control panel and ad blocks) must work correctly and be able to adjust to different sizes and scales of the search results page.

  • Set up transmission of video status data

    Video status information and information about player errors help improve the playback quality of your videos in the search.