HTML5 banner requirements

  1. Technical requirements

Technical requirements

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

The archive and files used in the HTML5 banner must meet the following requirements:
  1. The file and directory names can only contain Latin letters, digits, and the characters -._~.

  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 index.html file in the archive must be under 150 KB.

  5. The contents of the __MACOSX folders and the .DS_Store and Thumbs.db files will be ignored in the archive. 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 field, a mobile app (if installed), or the app's page in an app store (if the app isn't installed). Banner clicks must open this page by calling the yandexHTML5BannerApi.getClickURLNum(1) method.

    <a id="click_area" href="#" target="_blank">...</a> 
     // after the "<a href ...></a>" 
     element,  // assign its href attribute as follows:
        document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
  7. The following banner sizes are allowed: 160×600, 240×400, 240×600, 300×250, 300×300, 300×500, 300×600, 320×50, 320×100, 320×480, 336×280, 480×320, 728×90, 970×250, 1000×120.

    Specify the banner size in the <meta> element:

    <meta name="ad.size" content="width=300,height=250">
  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.

HTML5 banners must follow Yandex.Direct rules:

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

  • HTML5 banners must meet CPU utilization requirements.

    CPU utilization requirements

    A computer with Intel Core 2 Duo P9600 2.53 GHz CPU, 2 GB of RAM, 64-800 MB of video memory, and the 64-bit version of Windows 7 Professional is used to test CPU utilization. A single page containing only the banner under testing is loaded. The banner shouldn't utilize more than 50% of the CPU over a measurable time period (a second or a fraction of a second) or more than 70% of the CPU at any given moment. The Task Manager is used to measure processor utilization.

Do not use rapid animations, flickering graphic elements or a flashing background. The time before switching to the next frame should be long enough to read all of the text shown on the frame.

More about moderation requirements for display campaign creatives.

Have questions?

Attention. Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can see your current login in the upper-right corner of the screen. Our team can access your data only when processing your request.

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

Moscow: +7(495)780-65-20

Toll-free within Russia: 8(800)234-24-80, ext. 9


To access campaigns, a customer service specialist will need your PIN.