Scroll map

  1. Connecting
  2. Statistics on a group of pages
  3. Showing data in an iframe
  4. Page size restriction
  5. Questions and answers

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. For example, for a specific folder.

You can use multiple map display modes:

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

  • Data is stored for 15 days, including the current day.
  • The map is only displayed on the site pages where the Yandex Metrica tag is installed, and only if the site uses UTF-8 encoding.
  • When building a map from a URL, elements such as www, advertising tags, and the part of the link following # are removed from the URL, but regular URL parameters are not excluded. This is why the click map for the page will not be the same as for
  • Internet Explorer versions 8.0 and earlier are not supported.


  1. In Yandex Metrica, go to Settings (Tag).
  2. Select the Session Replay, scroll map, form analysis option.
  3. Save your changes.
  4. Install the updated code snippet on all the site's pages.
Note. The map may be disabled if it hasn't been viewed in the past six months. To resume session recording, enable the option again.

Statistics on a group of pages

To view statistics for a group of pages, you can use extra characters in the URL box.

Characters used for displaying statistics
Character Description Example
* Matches any number of any characters

Display data for all pages with URLs that start with, including the specified page:*.

If you enter the address without extra characters, Yandex Metrica provides a drop-down suggestion with the * character

~ The condition is a regular expression Show data for pages with URLs that match the regular expression. For example: ~*

Let's look at an example. You need to get statistics on pages in the directory In order for this data to be shown on the map, enter* in the address box (after you enter it, the same address is shown in the drop-down suggestion). Data is loaded automatically.

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

If your site is protected from being shown in an iframe (the X-Frame-Options header is used in the server settings), the collected data won't be available for viewing. To view the site's session data, you must change the server settings and add an exception for the domain and subdomains, as well as for your site's domain. Use the regular expression


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

location / {
        set $frame_options '';
        if ($http_referer !~ '^https?:\/\/([^\/]+\.)?(yourdomain\.com|webvisor\.com)\/'){
            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

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

Click map, link map or scroll map page loads endlessly

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.
  2. Restart the browser and open the maps again.
When a request is made, a "No data" notification appears in the map

This can happen if in the tag settings on the tab Filters the operation Replace https with 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: