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

• To use a replay snapshot, confirm replays are being captured for that page, or try switching breakpoints (desktop/tablet/mobile) — a replay may exist for a different device type.
• See Reading a Heatmap 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 — 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