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. A click on the banner opens the page specified in the Link to site or Turbo page field, the mobile app (if installed), or the app page in the store (if the app is not installed). Banner clicks must open this page by calling the yandexHTML5BannerApi.getClickURLNum(1) method.

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

Technical requirements for image banners

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

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

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.
  • products and services for adults (such as sex toys and erotic materials);
  • Firearm accessories.
  • Products similar in construction to weapons and their accessories.
  • Military subjects (transportation of military personnel, legal assistance in obtaining a military ID, and so on);
  • 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.);
  • Investments for obtaining citizenship, residence permit, permanent residence, and so on.
  • 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.

You can't place meaningful information and disclaimers in the upper part of the banner (for example: an age label can't be placed in the upper-right corner). Because this information is overlapped by system elements, for example, the menu icon, the banner will be rejected.

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, and 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.