# Heatmaps Installation

> Enable heatmap tracking on your site. Heatmaps activate automatically when session replay is configured in your web SDK.

Source: https://docs.oursprivacy.com/docs/heatmaps/installation

Heatmaps activate automatically when session replay is configured in your Ours Privacy web SDK. No additional scripts or configuration needed.

***

## Prerequisites

1. The [Ours Privacy web SDK](https://docs.oursprivacy.com/docs/session-replay) is installed on your site
2. Session replay is enabled

If session replay is not configured, no heatmap code is loaded and no events are emitted.

***

## Verify It's Working

1. Open your site and click around on a few pages
2. In your dashboard, go to **Heatmaps** in the left navigation
3. Pages should appear in the list within a few minutes
4. Click any page to see the heatmap detail view

![The Heatmaps list for Ours Health in September 2026, with a daily Clicks over time chart above ten pages ranked by clicks, each showing detected issues, rage and dead click rates, the device split, and an Investigate link.](https://docs.oursprivacy.com/img/heatmaps/heatmaps-img-5.jpg)

***

## Single-Page Applications

For SPAs (React, Next.js, Vue, etc.), the SDK automatically detects route changes. Each virtual navigation is treated as a separate pageview with its own scroll depth measurement. No additional configuration needed.

***

## Troubleshooting

**No pages appear in the heatmap list**

* Confirm session replay is enabled and capturing recordings
* Check that the date range includes the time period when traffic occurred
* Allow up to 5 minutes for new data to appear

**No replay snapshot for the page**

* To use a replay snapshot, confirm replays are being captured for that page, or try switching breakpoints (desktop/tablet/mobile), since a replay may exist for a different device type.
* See [Reading a Heatmap](https://docs.oursprivacy.com/docs/heatmaps/reading-heatmaps#review-the-replay) for how the replay is selected.

**Click positions look misaligned**

* Make sure you're viewing the correct breakpoint for the device type
* If your site layout changed recently, the replay snapshot may show an older version of the page
* Images or sections that load only on scroll may be missing from the replay snapshot; enable **Hide pop-ups** if a captured menu or banner obscures the replay

***

## Next Steps

* [Heatmaps Overview](https://docs.oursprivacy.com/docs/heatmaps): understand click, scroll, rage click, and dead click heatmaps
* [Reading a Heatmap](https://docs.oursprivacy.com/docs/heatmaps/reading-heatmaps): filter, compare, rank clicks by element, and export
* [Element Labels](https://docs.oursprivacy.com/docs/heatmaps/data-heatmap-id): improve element identification with `data-heatmap-id`
