Heatmap Data Missing

Diagnose and fix issues when heatmap data isn't displaying correctly.

No Heatmap Data

Check Requirements

Plan: Pro or higher required (heatmaps aren't available on Free)
Tracking: Base tracking must already be working
Heatmaps enabled: The feature must be turned on for the website

Enable Heatmaps

Heatmaps are turned on per website:

Open your website's dashboard and go to its Settings → Advanced
Under the tracking feature flags, turn Heatmaps ON
Wait for new traffic to come in (existing visits before you enabled it won't have heatmap data)

Minimum Data Required

Heatmaps need enough interactions to be meaningful:

Click heatmaps: 50+ clicks recommended
Scroll heatmaps: 100+ page views

Too little data: the viewer shows a "no data collected" state for that page.

Check Date Range

Make sure the selected time window includes the period when heatmaps were active
Heatmaps only show data from when the feature was enabled
Use the period selector in the viewer (7 days / 30 days / 90 days / 6 months — longer ranges depend on your plan)

Heatmap Not Matching Page

Page Changed

If the page design changed:

Older clicks may misalign with the current screenshot
Use the dated screenshot timeline in the viewer to compare against the layout from a given day
Reset the heatmap for the page if you want to start fresh (this permanently deletes that page's heatmap data)

Dynamic Content

Pages with dynamic content can be harder to read:

Different layouts for different users
A/B test variations
Personalized content

Responsive Design

Different viewport sizes can produce different click patterns. Desktop and mobile visitors behave differently, so keep that in mind when interpreting a single combined heatmap.

Click Heatmap Issues

Clicks Not Showing

Check the basics:

Confirm heatmaps are enabled for the website (Settings → Advanced → Heatmaps)
Make sure the page has had enough traffic since heatmaps were turned on
In the viewer, confirm you're on the Click view (the Click / Scroll toggle is in the top right)

Clicks in Wrong Location

Causes:

Page scrolled differently
Dynamic elements moved
Different viewport size

Interactive Elements Not Tracking

Some elements may not register clicks reliably:

Flash/plugin content
Canvas elements
Certain iframes

Scroll Heatmap Issues

Scroll Depth Not Showing

In the viewer, switch to the Scroll view using the Click / Scroll toggle, then check:

The page has enough page views (100+)
The page has scrollable content

Scroll Data Seems Wrong

Consider:

Different screen sizes show different data
Mobile users scroll differently
The view shows the aggregate distribution, not individual sessions

"0% scroll" for Many Users

Normal causes:

High bounce rate
Very quick visits
Bots (these are filtered out of tracking)

Specific Page Issues

Heatmap for Specific Page

To view a specific page:

Open Heatmaps (the Heatmaps tab under Audience in your website's dashboard, or Heatmaps in the main navigation)
Pick the page from the list on the left
View its heatmap

Page Not in List

If a page doesn't appear:

It needs some minimum traffic since heatmaps were enabled
Confirm the page is actually tracked

Dynamic URLs

For pages like /product/123, each distinct URL is treated as its own page in the list. Pick the specific URL you want to analyze.

SPA (Single Page App) Issues

Heatmaps Not Working in SPA

The tracker automatically detects route changes triggered through the browser History API (pushState / replaceState / popstate), so most SPAs work out of the box. If your router doesn't use the History API, send a manual page view on each route change:

// Track virtual page views
router.afterEach((to) => {
  if (window.zenovay) {
    window.zenovay('page');
  }
});

Multiple Pages Merged

Make sure each route maps to a unique URL path so different views aren't recorded against the same page.

Rendering Issues

Heatmap Overlay Broken

Try:

Refresh the page
Clear browser cache
Try a different browser

Colors Not Showing

Check:

Enough data has been collected for the page
You aren't zoomed in too far (use the zoom controls in the viewer to reset)

Page Screenshot Wrong or Outdated

Zenovay captures the page screenshot automatically, so there's no manual "refresh" button. If the screenshot looks outdated:

A newer screenshot is captured automatically as the page keeps getting traffic
Use the dated screenshot timeline at the bottom of the viewer to step through captures from different days

Data Accuracy

Clicks Seem Wrong

Verify accuracy:

Visit the page yourself and click around
Wait a few minutes
Reload the heatmap and check if your clicks appear

Data Doesn't Match Expectations