Technical requirements for banners

You can upload an image banner or HTML5 banner.

Technical requirements for image banners

You can add several variants of your image banner to be served on different Yandex Home page versions:

Full version of the Yandex Home page and new Yandex Browser tab Mobile version of the Yandex Home page
Size in pixels 1456 × 180 640 × 134
Maximum file size 1 MB
Format JPG, PNG or GIF

Technical requirements for HTML5 banners

HTML5 banners must be ZIP files that contain one HTML file and JavaScript, JSON, CSS, JPEG, GIF, PNG, or SVG files.

Size in pixels 1456 × 180
Maximum archive size 1 MB

HTML5 banners aren't placed on the mobile version of the Yandex Home page.

The archive and files used in the banner must meet the following requirements:

  1. The file and directory names can only contain Latin letters, digits, and the symbols -._~.

  2. All links in an HTML5 banner must be relative and lead to other files in the archive.

  3. The archive can contain up to 20 files. Include source code from JavaScript, CSS, and SVG in the HTML file and combine all bitmaps into a single file (a sprite atlas).

  4. The maximum size of the archived index.html must be less than 150 KB.

  5. The archive will ignore the contents of the __MACOSX folder andDS_Store and Thumbs.db files. These are the operating system's auxiliary files which are not necessary for the HTML5 banner to work.

  6. |||UNTRANSLATED_CONTENT_START|||<a id="click_area" href="#" target="_blank">...</a> 
    // после элемента "<a href ...></a>" 
    // присваиваем для него значение атрибута href так: 
       document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
  7. The HTML5 banner size must be specified in the content attribute of the meta tag. See the example below:
    <meta name="ad.size" content="width=1456,height=180">
  8. External calls to Yandex-hosted JavaScript libraries are allowed. If an HTML5 banner uses a different library, include it in the archive source code.

  9. All event handlers must be explicitly specified within the script tag, for example:

        document.onload = init;
  10. The link in an HTML5 banner must not exceed 1024 characters and must be UTF-8 encoded.

  11. The banner must not use statistics collection tools (pixels, tags, etc.).

    When you create a campaign, you can specify a Yandex Audience pixel or ADFOX tag (to learn more, see How to launch a campaign). You can also use UTM tags in the link to your website.

  12. A banner can feature the View again button for restarting the scenario.

Download a sample HTML5 banner