---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com.tr/support/metrica/en/behavior/scroll-map.md
  - https://yandex.com.tr/support/metrica/es/behavior/scroll-map.md
  - https://yandex.com.tr/support/metrica/pt/behavior/scroll-map.md
  - https://yandex.com.tr/support/metrica/ru/behavior/scroll-map.md
  - https://yandex.com.tr/support/metrica/tr/behavior/scroll-map.md
title: Scroll map
description: A tool for analyzing where visitors' attention is spread on your site's pages. The scroll map can help you select the best page length and optimally place important information.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/en/llms.txt


# Scroll map

The _scroll map_ is a tool for analyzing how site users pay attention to particular areas of website pages. The scroll map can help you select the best page length and optimally place important information.

It shows the average viewing time and number of views for a specific part of the page that you put the cursor on. You can also get statistics for a [group of pages](#group). For example, for a specific folder.

<!-- source: en/_includes/behavior/click-map/id-case/map-03.md -->
You can use multiple map display modes:
<!-- endsource: en/_includes/behavior/click-map/id-case/map-03.md -->


- Heat map: Changes to page viewing time are shown in color-coded zones.
- Transparency map: Areas of the page that the user spent less time viewing are darkened, while areas that were viewed longer are more transparent.

**Minimum** — The minimum viewing time out of the total time of [pageviews](*просмотров) of the selected page.

**Maximum** — The maximum viewing time out of the total number of pageviews of the selected page.

{% note info %}

- Data is stored for 15 days, including the current day.
- <!-- source: en/_includes/behavior/click-map/id-case/rule-map-1.md -->
  The map is only displayed on those pages of the site where the Yandex Metrica tag is installed, and also if the site uses [UTF-8 encoding](https://en.wikipedia.org/wiki/UTF-8).
  <!-- endsource: en/_includes/behavior/click-map/id-case/rule-map-1.md -->
    
- <!-- source: en/_includes/behavior/click-map/id-case/rule-map-2.md -->
  When building the map, elements such as `www`, advertising tags, and the part of the link after `#` (inclusive) are excluded from the URL, but regular URL parameters are not excluded. This is why the click maps for the pages `http://example.com?id=1` and `http://example.com?id=2` will be different.
  <!-- endsource: en/_includes/behavior/click-map/id-case/rule-map-2.md -->
    
- <!-- source: en/_includes/behavior/click-map/id-case/rule-map-4.md -->
  Internet Explorer versions 8.0 and earlier are not supported.
  <!-- endsource: en/_includes/behavior/click-map/id-case/rule-map-4.md -->

{% endnote %}

## Connecting {#set}

1. In Yandex Metrica, go to **Settings** → **Tag**.
1. Select the **Session Replay, scroll map, form analysis** option.
1. Save the changes.
1. Install the updated tag code on all the site’s pages.


{% note info %}

The map may be disabled if it hasn’t been viewed in the past six months. To resume session recording, enable the option again.

{% endnote %}



## Statistics on a group of pages {#group}

<!-- source: en/_includes/behavior/click-map/id-group/group1.md -->
To view statistics for a group of pages, you can use extra characters in the URL box.
<!-- endsource: en/_includes/behavior/click-map/id-group/group1.md -->

![](../_assets/map-scroll-url.png){.border-yes}

<!-- source: en/_includes/behavior/click-map/id-group/group2.md -->
## Characters used for displaying statistics {#group}

#|
||
**Character**
|
**Description**
|
**Example**
||
||
\*
|
Matches any number of any characters
|
Display data for all pages with URLs that start with https://example.com/goods/, including the specified page: `https://example.com/goods/*`.

If you enter the address without extra characters, Metrica will offer a drop-down suggestion with the * character
||
||
~
|
The condition is a regular expression
|
Show data for pages with a URL matching a [regular expression](https://yandex.com.tr/support/metrica/en/general/regexp.md). For example: `~http://example.com/.*`
||
|#
<!-- endsource: en/_includes/behavior/click-map/id-group/group2.md -->


<!-- source: en/_includes/behavior/click-map/id-group/group3.md -->
Let’s look at an example. You need to get statistics on pages in the directory https://example.com/goods/. In order for this data to be shown on the map, enter https://example.com/goods/* in the address box (after you enter it, the same address is shown in the drop-down suggestion). Data is loaded automatically.
<!-- endsource: en/_includes/behavior/click-map/id-group/group3.md -->


The map will be displayed on the most popular page with a URL that matches what you specified. Numerical indicators (the average session length and number of sessions) will be combined for all the pages that match the condition.


## Showing data in an iframe {#iframe}

If your site is protected from being shown in an iframe (the `X-Frame-Options` header is used in the server settings), you won't be able to view the collected data. To view the site’s session data, use a regular expression in the server settings to add exceptions for the following domains:

- your website
- metrika.yandex.ru
- metrika.yandex.by
- metrica.yandex.com
- metrica.yandex.com.tr
- webvisor.com and its subdomains

```no-highlight
^https?:\/\/([^\/]+\.)?(yourdomain\.com|webvisor\.com|metri[ck]a\.yandex\.(com|ru|by|com\.tr))\/
```

If you use nginx, add the following exceptions to your configuration:

```no-highlight
location / {
        set $frame_options '';
        if ($http_referer !~ '^https?:\/\/([^\/]+\.)?(yourdomain\.com|webvisor\.com|metri[ck]a\.yandex\.(com|ru|by|com\.tr))\/'){
            set $frame_options 'SAMEORIGIN';
        }
        add_header X-Frame-Options $frame_options;
        ...
    }
```

where `yourdomain\.com` is the site's domain name. Use your site’s domain zone (it may differ from .com).


## Page size restriction {#display-map}

In order to display data on the map, the website pages must meet certain size restrictions. The values below are for displaying the map in various browsers:


#|
||
**Browser**
|
**Maximum page height/width (in pixels)**
|
**Maximum number of pixels**
||
||
Mozilla Firefox
|
32,767
|
472,907,776 (22,528 x 20,992)
||
||
Chrome
|
32,767
|
268,435,456 (16,384 x 16,384)
||
||
Internet Explorer
|
8,192
|
67,108,864 (8,192 x 8,192)
||
|#


## Questions and answers {#qanda}

{% cut "Click map, link map or scroll map page loads endlessly" %} {#redirect}


In Safari 12 and higher, the click map, link map, or scroll map page may never finish loading due to an option in the browser settings.

1. Go to the **Privacy** tab and disable the **Prevent cross-site tracking** option.
1. Restart the browser and open the maps again.


{% endcut %}

{% cut "When a request is made, a “No data” notification appears in the map" %} {#no-data}


This can happen if in the tag settings on the tab **Filters** the action **Change from https to http** is enabled. In this case, all URLs with HTTP protocols are on the map, and the site itself has the HTTPS protocol.

To start displaying the data, disable the operation.
![](../_assets/https-to-http.png){.border-yes}

{% endcut %}

<!-- source: en/_includes/buttons/chat-button.md -->
[Chat with us](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->
<!-- endsource: en/_includes/buttons/chat-button.md -->

<!-- source: en/_includes/buttons/mail-button.md -->
<div class="cut-button">

{% cut "Write an email" %}

<!-- source: en/_includes/popup/id-popup/wrong-sup.md -->
Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.
<!-- endsource: en/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com.tr/surveys/1706/?&iframe=1&lang=tr">
  </iframe>
</div>

{% endcut %}

</div>

<!-- source: en/_includes/styles/cut-button.md -->

<!-- endsource: en/_includes/styles/cut-button.md -->
<!-- endsource: en/_includes/buttons/mail-button.md -->


<!-- source: en/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Useful links

- [Demo tag](https://metrica.yandex.com.tr/r/dashboard?)
- [Add a tag](https://metrica.yandex.com.tr/add/)
- [Free tag setup](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com.tr/metrika/)
- [Suggest your idea](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Discuss in Telegram](https://t.me/yandexmetrika)
|
Online training

- [Get a Yandex Metrica certificate](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Take a training course](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: en/_includes/styles/table-style.md -->

<!-- endsource: en/_includes/styles/table-style.md -->
<!-- endsource: en/_includes/footer-links.md -->

<!-- source: en/_includes/styles/cut-button.md -->

<!-- endsource: en/_includes/styles/cut-button.md -->

<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->

<!-- source: en/_includes/styles/border-style.md -->

<!-- endsource: en/_includes/styles/border-style.md -->

[*просмотров]: Loading one of a site’s pages when a user navigates to it. Pageviews also include page refreshes, AJAX site updates, and sending data using the [hit method](https://yandex.com.tr/support/metrica/en/objects/hit.md).