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 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

---

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

• The heatmap falls back to a live-site backdrop automatically and tells you it did — you can still read the overlays.
• To use a replay snapshot instead, confirm replays are being captured for that page, or try switching breakpoints (desktop/tablet/mobile) — a replay may exist for a different device type.
• If the live-site view shows an explainer instead of your page, the site blocks being loaded in a frame; open it in a new tab from the link provided. See Reading a Heatmap.

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 — switch to the live-site backdrop to overlay clicks on the current layout
• Images or sections that load only on scroll may be missing from the replay snapshot; the live-site backdrop shows them in place

---

Next Steps

• Heatmaps Overview — understand click, scroll, rage click, and dead click heatmaps
• Reading a Heatmap — filter, compare, rank clicks by element, and export
• Element Labels — improve element identification with data-heatmap-id