Analytics

How to see where visitors click and scroll (Heatmaps)

How to see where visitors click and scroll (Heatmaps)

TeleportHQ Heatmaps show where visitors click on a page of your published site and how far down they scroll, separately for phones, tablets and computers. In the editor, click Growth, then Analytics, then Heatmaps, and pick a page and a device. Click Show on canvas to draw the map over that page in the editor, where you can fix what you see.

Before you start

What TeleportHQ records for heatmaps

On every page of your published TeleportHQ site that analytics tracks, the analytics script records:

  • Every click, with where on the page it landed and the element it landed in.
  • The device type, from the width of the visitor's window: Mobile under 768 pixels, Tablet under 1024 pixels and Desktop above. A phone and a computer lay the page out differently, so their clicks are never mixed.
  • Rage clicks: three clicks or more on the same spot in less than a second, as when a visitor hammers something that doesn't answer.
  • Dead clicks: a click on something that looks clickable, such as a link, a button or anything with a pointer cursor, after which nothing on the page changes within half a second.
  • How far the visitor scrolled, in tenths of the page. This is recorded when the visitor leaves the page.
  • Where your buttons sit on the page, measured on 1 page view in 20. It tells how many visitors scrolled far enough to see a button.

Clicks are named by the nearest element TeleportHQ tracks around them: buttons, links, forms and their fields, images, videos, headings (H1 to H3), any element with an ID, the sections of the page, and each item of a repeated list, such as a product card. A click on a paragraph inside a section counts for the section.

Nothing is recorded on localhost, by automated browsers, on pages you switched analytics off for, or while you look at the map on your live site. Heatmaps never record what visitors type.

Open a page's heatmap

  1. In the left sidebar, click Growth, then Analytics ("See who visits your site").
  2. In the column on the left of Analytics, click Heatmaps ("Where they click & scroll").
  3. At the top right, pick a date range, for example Last 30 days.
  4. Under Page, pick the page. Each page reads as its name and its address, for example Menu · /menu. The Heatmaps tab opens on your most-viewed page.
  5. Under Device, click Mobile, Tablet or Desktop. The Heatmaps tab starts on the device most of your visitors use.
  6. Under Map, click Clicks or Scroll. This chooses what Show on canvas draws.
The Heatmaps tab of TeleportHQ Analytics, with the Device and Map switches and the Show on canvas button highlighted above the clicked elements and the scroll bars

Read the heatmap

What gets clicked. The elements of the page, ranked by their share of its clicks, for the device you picked (up to 25 rows):

  • Element: the element's name in your project. "Element no longer in the project" means it was deleted since.
  • Share: its part of all the page's clicks.
  • Clicks and Visitors: how many clicks, by how many visitors.
  • Rage and Dead: the rage clicks and dead clicks it collected. A row with either is marked with an orange line on its left: visitors expected a reaction there.

To find an element on the page, click the arrow (↗) next to its name (tooltip Select on canvas). TeleportHQ draws the map on the canvas and selects the element.

How far visitors scroll. Ten bars, from 0–10% at the top of the page to 90–100% at the bottom. Each bar is the share of page views that got that far down before the visitor left. Whatever sits below the bar that reads 50% is seen by fewer than half of your visitors, so move what matters above it.

Draw the map on the canvas

  1. On the Heatmaps tab, click Show on canvas. TeleportHQ opens the page on the canvas and sets the canvas to the device's width: 414 pixels for Mobile, 834 pixels for Tablet and your desktop width for Desktop.
  2. Read the map over the page. In a click map, colored spots show where visitors clicked, from blue (few clicks) through green and yellow to red (the most clicks). Every element with at least 1% of the clicks gets a label, for example "12% · 34 clicks · 2 rage". In a scroll map, each tenth of the page reads, for example, "62% reach here".
  3. To switch maps, click Show scroll or Show clicks in the legend at the top left of the page. The legend also says what's shown, for example Clicks · Desktop · Last 30 days, and how many clicks are drawn.
  4. Edit the page as usual: the map lets your clicks through to the canvas.
  5. To remove the map, click Hide in the legend.
A TeleportHQ click heatmap drawn over the homepage on the canvas, with its legend and the Show scroll and Hide buttons highlighted

To return to the Heatmaps tab, click Back to Analytics above the canvas while it shows, or open Growth → Analytics again. There, Hide from canvas also removes the map.

See the map on your live site

  1. On the Heatmaps tab, click View on live site. It's greyed out until the site is published (tooltip "Publish first").
  2. A new browser tab opens the published page with the map drawn on it. The legend at its top left offers Show scroll (or Show clicks) and Close.
  3. To see the map of another device, make the browser window narrower or wider. The legend says "resize the window for another device".

The live-site map always covers the last 30 days, whatever range the Heatmaps tab shows. Your own visit to that tab isn't counted. The link works for one hour and only on the page it opened; click View on live site again for a new one.

See one element's numbers in the right panel

Select an element on the canvas, for example the Order now button. In the right panel, below Attributes, the Visitors · last 30 days section shows:

  • Clicks and Visitors: how often visitors clicked it, and how many visitors did.
  • Seen by: the share of visitors who scrolled far enough to see it. This is measured for buttons; other elements show a dash.
  • A warning when it collected rage or dead clicks, for example "3 rage clicks · 1 dead clicks — visitors expected a reaction here."
  • Show heatmap: draws the desktop click map of the page where the element is clicked most, over the last 30 days.

The section appears for the elements TeleportHQ tracks (see above), once the site is published with visitor analytics on.

Check that it worked

Open your live site on your phone. Tap a few buttons on one page, scroll to the bottom, then go to another page. After a few minutes, on the Heatmaps tab, pick that page and Mobile: your taps show in What gets clicked, and How far visitors scroll has bars.

Troubleshooting

"No clicks on this page yet for this device." No visitor on that device clicked on this page in the date range. Pick another device or a longer range.

"Visitors clicked this page, but not where they clicked." Your site was last published before TeleportHQ recorded where clicks land, so those clicks have no position. Publish the site again: clicks from then on show on the map. On the canvas, the legend reads "Publish the site again to map clicks".

"No scroll data for this page yet." How far visitors scroll is recorded when they leave the page. Wait for more visits, or pick a longer range.

The Page list says "No pages visited yet" Your site has no visits in the date range. Check that it's published with visitor analytics on, then pick a longer range.

Heatmaps stay empty although Analytics shows visits Your live site still has an older analytics script. Publish your site again, then give it time to collect clicks.

"No page in this project answers to that address, so there is nothing to draw it on." The page was deleted or its address changed since those visits. Click View on live site to see the map on the published page instead.

"Publish the site first to view a heatmap on it." Publish your site, then click View on live site again.

"Couldn't open the live site. Please try again." Click View on live site again. If it keeps happening, check your connection.

"This map is a …% sample of the page's clicks — the shares still hold." On a very busy page, TeleportHQ keeps every click position up to a daily limit per device, then one in ten. The shares and the ranking are still right.

Good to know

  • The spots on the click map go back 30 days at most. Click positions are deleted after 30 days. What gets clicked and How far visitors scroll cover the whole date range you pick.
  • Long sessions are trimmed. In one page view, the first 40 clicks are all kept; after that, clicks on links and buttons are kept and every other click elsewhere.
  • Show heatmap in the right panel always shows Desktop. To see a phone's map of that page, use the Heatmaps tab.
  • Only sites TeleportHQ publishes record heatmaps. Code you download and host yourself doesn't report clicks to TeleportHQ.
Share

Related Articles

How to see who visits your site (Analytics)

In TeleportHQ, click Growth in the left sidebar, then Analytics, to see your published site's visitors, page views, traffic sources, countries, devices, most-viewed pages, clicks, conversions, heatmaps, returning visitors, funnels and A/B tests, for the last 24 hours, the last 7, 30 or 90 days or a custom range.

How to see which visits lead to sales and sign-ups (Conversions)

In TeleportHQ, open Growth → Analytics → Conversions to see how many visits reached your site's goal (an order, a booking, a sent form, a sign-up or a newsletter sign-up), with each rate and what it was counted from, every goal your site recorded, and the goal broken down by channel, campaign, page, country or device, credited by the attribution model you choose.

How to test two versions of an element on your page (Experiments)

In TeleportHQ, select an element such as a headline, a section, a button or an image, click Try a variation in the A/B test section of the right panel, edit the copy and publish; half your visitors then see each version, Growth → Analytics → Experiments shows which one converts more, and one click keeps the winner.

How to turn visitor analytics on or off and choose tracked pages

In TeleportHQ, open Growth, click the Growth Settings gear and flip the Visitor analytics switch, then publish so the change reaches your live site; Tracked pages below the switch lists the pages you want to record visits on.

Does TeleportHQ analytics use cookies?

No. TeleportHQ's built-in visitor analytics never sets cookies and, like A/B tests and popups, stores nothing in visitors' browsers unless they accept your cookie banner; it records anonymous page views and clicks, doesn't keep IP addresses with visit records, and deletes detailed visit records after 90 days.

How to publish your site

In TeleportHQ, click Publish at the top right of the editor, keep Production selected, and click Publish to Production; a progress bar beside the button shows each step, and after a few minutes your site is live on a free TeleportHQ address that you can share.