Banner requirements

You can upload an image banner or HTML5 banner.

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. When a user clicks on the banner, the page indicated in the Link to site field or a Turbo page opens. Calls to the yandexHTML5BannerApi.getClickNum(1) method should generate click-throughs to that page in the banner.

    |||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 animation scenario.

Download a sample 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 Yandex Home page and new Yandex Browser tab Mobile Yandex Home page version
Size in pixels 1456 × 180 640 × 134
Maximum file size 1 MB
Format JPG, PNG or GIF

Moderation requirements

Follow the recommendations to make sure your banner passes moderation on the first try.

Prohibited subjects
Banners in the following categories are not accepted for placement on the Yandex Home page:
  • politics
  • magic and esotericism
  • religious items and services
  • debt collection services
  • funeral products and services
  • dating websites or marriage agencies
  • services of detectives and private security companies
  • Products and services from sensitive categories (for example, underwear).
  • products and services for adults (such as sex toys and erotic materials);
  • Products that resemble weapons
  • website optimization and SEO services
  • disinfection and pest control services
  • certain financial services and training courses on them (microfinancing, loan offers from individuals, binary options, Forex dealer activities, transactions with Forex dealers, etc.);
  • other topics that do not comply with Yandex editorial policy

This list is not exhaustive and can be changed by Yandex at any time.

Notices and restrictions

All information required by legislation and the Yandex Ad Serving Rules must be present in the banner, including age restrictions and notices. It must be clearly visible and easy to read.

Texts, website, link to site

Texts and the advertiser's website must meet the same requirements that apply to all other ads served on Yandex.Direct.

Banner design
  • Banners must not contain standard user interface elements (cursor, search bar, buttons, and so on) that do not perform their applicable functions.
  • The banner can't have a frame or border.
  • The background must not be transparent.
Recommendations for banners:

A banner that fully meets the above recommendations is subject to an additional user perception check: the banner is benchmarked against the reference banners approved by our designers. If a banner gets a high rating based on the benchmarking results, it's likely that it will appeal to the target audience.

Banner display

The banner must meet the following rendering recommendations:

  • When zooming the page in the browser from 100% to 200%, the banner should show no artifacts or distortions. The quality of banners for the full version of the Yandex Home page is checked on the following screen resolutions: macOS — 1440 × 900 pixels, Safari browser, Windows — 1366 × 768 pixels, Yandex Browser, Firefox, Opera.

  • Don't use graphical elements with fast movement, flashing elements, or blinking backgrounds.

    What is considered fast movement and blinking?

    Blinking is defined as changes in the color, saturation or brightness by more than 40% that occurs with a frequency of more than once every two seconds.

    Fast movement is a change of an element's position on the banner by more than 100% of the element's size or 50% of the banner's size in one second.

    These are examples, rather than strict criteria for banner compliance with Yandex requirements. A banner with the aforementioned issues will most likely be rejected. However, there may be cases when a banner with fewer changes is identified as annoying, and vice versa, a banner with more changes might pass moderation. The decision is made individually in each case.

  • The time it takes to switch between frames should be sufficient to read all of the text shown on that frame.

  • Don't use graphic elements with poor quality, such as distorted or low-resolution images (with visible pixels), low-fi or noisy images, or images with compression artifacts.
  • The advertised site must open in a new window (and only open after a user clicks on the HTML5 banner).

  • HTML5 banners should display correctly and work the same way for all users on all platforms throughout the ad campaign in the following browsers: Yandex Browser 14 and higher, Google Chrome 14 and higher, Mozilla Firefox 14 and higher, Opera 14 and higher, Internet Explorer 9 and higher, and Microsoft Edge.

  • In HTML5, you can't use video or audio clips, script behavior that is annoying or malicious (like scripts that launch pop-ups or spoof IP addresses), browser extensions or plugins (Adobe Flash and others). The banner source code should not be obfuscated, meaning it should not be difficult to analyze.

Duration of animation
  • Do not use blinking banners or banner elements that distract the user.
  • Banner elements may change no more than once every 2 seconds.
  • On the freeze frame, the banner must display the main advertising message.
  • An HTML5 banner can feature the View again button for restarting the animation scenario. An HTML5 banner can be interactive and respond to mouse movement and/or banner clicks to change the banner image in response to the action.