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

Detail page says "No replay available"

• A session replay recording is needed for the page background. Confirm replays are being captured for that page.
• Try switching breakpoints (desktop/tablet/mobile) — a replay may exist for a different device type

Click positions look misaligned

• Make sure you're viewing the correct breakpoint for the device type
• If your site layout changed recently, the replay background may show an older version of the page

---

Next Steps

• Heatmaps Overview — understand click, scroll, rage click, and dead click heatmaps
• Element Labels — improve element identification with data-heatmap-id