---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/support/partner/en/web/units/types/overlay.md
  - https://yandex.com/support/partner/ru/web/units/types/overlay.md
  - href: en/web/units/types/overlay.md
    type: text/markdown
    title: Markdown version
  - href: ../../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/partner/en/llms.txt

# Overlay ᵝ

Overlay is an ad unit that appears on top of the page on mobile devices and covers part of the screen while keeping the rest of the content visible. This format helps draw attention to the ad without covering the entire page.

The ad unit displays after the page loads and stays fixed to the bottom of the screen on top of the site content. Users can close it at any time once the close button appears.

{% note info %}

Beta version. This format is currently in beta and supported only for mobile devices.

{% endnote %}

![](../../../_images/overlay-example.png){width=250px}

## Available ad formats

The following ad formats can be displayed in the Overlay unit:

- Combinatorial ads in the [Adaptive](https://yandex.com/support/partner/en/web/units/formats/main.md#adaptive) ![](../../../_images/sd-label.svg) format.
- [Display ads](https://yandex.com/support/partner/en/web/units/formats/media.md): They are selected automatically and occupy the maximum unit area. The aspect ratio of display ads is close to the size of the user's screen.
- [Video ads](https://yandex.com/support/partner/en/web/units/formats/video.md).

## How to create an Overlay unit

1. <!-- source: en/_includes/web/units/types/create.md -->
   In the Yandex Advertising Network interface, go to **Website Ads** → **Ad units** and click **New ad unit**.
   <!-- endsource: en/_includes/web/units/types/create.md -->

1. <!-- source: en/_includes/web/units/types/create.md -->
   Select the site that you want to create an ad unit for and click **More**.
   <!-- endsource: en/_includes/web/units/types/create.md -->

   {% note info %}

   Keep in mind that this format is only available for mobile versions of sites.

   {% endnote %}

1. Select **Overlay ᵝ** as the unit type.

1. <!-- source: en/_includes/web/units/types/create.md -->
   Enter a unit name to be used in the Yandex Advertising Network interface.
   <!-- endsource: en/_includes/web/units/types/create.md -->

1. <!-- source: en/_includes/web/units/types/create.md -->
   Select a CPM strategy:

   - **Maximum revenue**: Determine the minimum cost of impressions automatically. With this option, you can effectively fill placements and maximize revenue for the site owner.

   - **CPMV threshold**: Set your own minimum cost per thousand impressions based on a [viewability check](*viewability-check). The CPMV floor can be set in rubles, US dollars, or euros. You can change the floor currency in your [account settings](https://yandex.com/support/partner/en/account-settings.md).

     {% note alert %}

     Setting a CPMV floor can reduce the unit fill rate and, therefore, decrease your income.

     {% endnote %}
   <!-- endsource: en/_includes/web/units/types/create.md -->

1. Configure the unit display settings:<br><br>

    #|
    || **Parameter** | **Description** ||
    ||**Size**|
    The size of the ad unit:
    - **Compact**: The ad unit takes up about 45% of the screen height.
    - **Standard**: The ad unit takes up about 60% of the screen height (recommended).
    - **Large**: The ad unit takes up about 75% of the screen height.||
    ||**Background Overlay**|
    Use this to dim the page behind the ad unit to make the creative stand out.||
    ||**Impression limit** and **Restriction period**|

    {% include notitle [display-settings](../../../_includes/web/units/types/display-settings.md) %} 

    We recommend that you don't show this ad unit too often, as it may distract users from your site content.||
    ||**Close button delay**|
    The time delay before the close button appears. Users can only close the ad unit after the specified time has passed.

    By default, this is set to **0 sec** (the close button appears immediately). You can set a delay of 1 to 3 seconds before the button appears.
    
    If you delay the close button, keep an eye on user reaction: delays can draw attention away from your site content and affect the user experience.
    ||
    ||**Close ad after timer expires**| This parameter specifies whether the ad creative closes automatically after a set amount of time:
    - **Auto**: Video ads close 10 seconds after playback ends. All other formats close 10 seconds after being served.
    - **Yes**: Always close the ad after the timer expires.
    - **No**: Don't close the ad automatically after the timer expires.    
    ||
    ||**Theme**|
    Choose a theme: **Dark** or **Light**. The default option is Light theme. Dark theme units have a different background and color scheme for their text, border, buttons, and other elements. The selected theme applies to all ad formats within the unit.
||
    |#

1. Choose how you want to configure ad formats:

    - **Use standard settings** to serve all available formats in the ad unit: combinatorial ads, display ads, and video ads. The design and display parameters are determined automatically.

    - **Configure formats manually** to disable specific ad formats or change their settings.

1. <!-- source: en/_includes/web/units/types/create.md -->
   Click **Create**. A window with the ad tag will open. Use this ad tag to place the ad unit on your site.
   <!-- endsource: en/_includes/web/units/types/create.md -->

<!-- source: en/_includes/web/units/types/create.md -->
Once you save the ad unit, it will be assigned a unique identifier (`ID`). It consists of a product ID (`R-A`), site ID (`site_id`), and the unit's serial number.
<!-- endsource: en/_includes/web/units/types/create.md -->

## How to add an Overlay unit to your site

1. Get the ad tag: create a new unit or click **Get code** in the settings of an existing unit.

1. Copy the ad loader code to your clipboard and paste it into the `<head>` of all pages where you want to show the Overlay unit. The loader code is only embedded on the page once and is used to call all Yandex Advertising Network units.

1. Paste the ad unit code into the `<head>` right after the loader code, or place it inside the `<body>` of the page.

<!-- source: en/_includes/feedback-forms/units-buttons.md -->
## Contact support




<details>
    <summary class="button">Write to WhatsApp</summary>
    <img src="https://yastatic.net/s3/doc-binary/src/support/partner/qr-codes/gr-code-en-new.svg" style="width: 100%; display: block;"/>
    <a href="https://wa.me/74952583554?utm_source=yan&utm_medium=help&utm_campaign=en" style="display: block; text-align: left; margin-left: 18px; color: #5889FF;">Go to WhatsApp</a>
</details>

<details>
    <summary class="button">Write to Telegram</summary>
    <img src="https://yastatic.net/s3/doc-binary/src/support/partner/en/qr-codes/qr-code-en-telegram.svg" style="width: 100%; position: relative; left: -18px; display: block;"/>
    <a href="http://t.me/YanSupport_Bot" style="display: block; text-align: left; margin-left: 18px; color: #5889FF;">Go to Telegram</a>
</details> 


<a href="https://yandex.ru/chat?context=%7B%22entrypoint%22%3A%22%7B%5C%22entrypoint%5C%22%3A%5C%22help%5C%22%2C%5C%22a_pagename%5C%22%3A%5C%22partner-en%5C%22%7D%22%7D#/user/00155607-f40f-9af8-7910-84a29fd95914"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Write to chat</span> <!--текст на кнопке--> 
</a>


<a href="https://forms.yandex.com/surveys/10014688/?lang=en"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Send an email</span> <!--текст на кнопке--> 
</a>



<!-- source: en/_includes/feedback-forms/button-style.md -->

<!-- endsource: en/_includes/feedback-forms/button-style.md -->

<div width="100%" align="center"> 
<br><br>
You can also go to
<br><br>

[![](https://yastatic.net/s3/doc-binary/src/support/mobile-ads/en/logo/rsya.svg)](https://partner.yandex.com)

</div>

<div><br><br></div>
<div class="container" style="padding: 0;">
  <div class="column">
      <p style="font-size: large;">Useful links</p>
      <ul>
         <li><a href="https://t.me/YANpartner/" target="_blank">Yandex Advertising Network Telegram channel</a></li>
         <li><a href="https://yandex.ru/legal/partner/" target="_blank">Rules of participation</a></li>
         <li><a href="https://yandex.com/legal/yan_service_offer/" target="_blank">Yandex Advertising Network Terms of Offer</a></li>
      </ul>
  </div>   
</div>
<div><br><br></div>


<!-- endsource: en/_includes/feedback-forms/units-buttons.md -->




[*viewability-check]: An impression is considered viewable if at least 50% of the unit area shows on the screen for at least two seconds.
{% included (../../../_includes/web/units/types/display-settings.md) %}
## Impression settings {#settings}

  - **Impression limit**: Specify the maximum number of impressions for a unique user (from 1 to 3).

  - **Restriction period**: Set the period during which the unit can be displayed the maximum number of times.

  For example, if you want the unit to appear no more than 1 time per hour, select 1 in the **Impression limit** field and select 1 hour in the **Restriction period** field.

  {% note alert %}

  For periods of 5 and 10 minutes, the impression limit can't be more than 1.

  {% endnote %}

{% endincluded %}