how to check if heatmap is working correctly
how to check if heatmap is working correctly
how to check if heatmap is working correctly
Hi event, Please stand by as I search the Mixpanel knowledge base for an AI-powered answer. I normally take about 15 seconds or so. In case AI cannot answer your question, feel free to reach out to Mixpanel support at mixpanel.com/get-support. If you have follow-up questions for this thread, please tag me again with your question: @kapa.ai <follow-up question> 👋
Feel free to ask a follow-up question once I've answered by mentioning me with @kapa.ai
To check if Mixpanel Heatmaps are working correctly, follow these steps: 1. Verify Implementation
Ensure you have enabled Session Replay and set record_heatmap_data: true during Mixpanel initialization. For example:
record_sessions_percent: 1, // Session Replay enabled
record_heatmap_data: true // Enable Heatmap data collection
});
```LBKS Alternatively, if you use Autocapture for clicks, ensure it is enabled and that Session Replay is active. Note that clicks from Autocapture are billable, while those from `record_heatmap_data` are not [Using Heatmaps](https://docs.mixpanel.com/docs/session-replay/heatmaps#using-heatmaps) [Heatmaps for Web](https://docs.mixpanel.com/docs/session-replay/heatmaps#overview).LBKS2. **Trigger and Inspect Events**
Interact with your site to generate click events. Use the Mixpanel Events report to confirm that `$mp_click` events are being recorded during session replays. You can also use the [Mixpanel Data Inspector browser extension](https://docs.mixpanel.com/docs/tracking-methods/data-inspector) to view events in real time and inspect their payloads for accuracy.LBKS3. **Check Heatmap in Mixpanel UI**
- Go to the Heatmaps section from the Mixpanel Home page.
- Select the relevant URL or use wildcards to group similar pages.
- Ensure that clicks are visualized on the heatmap and that the data matches your expectations (e.g., hot spots appear where you clicked).
- Use the Click Map and Heatmap toggles to compare element-level and page-level activity.
- Click on elements to view associated events, users, and session replays for further validation [Using Heatmaps](https://docs.mixpanel.com/docs/session-replay/heatmaps#using-heatmaps).LBKS4. **Validate Data Consistency**
- Confirm that the number and location of clicks in the heatmap correspond to your test actions.
- Use session replays to watch the actual user journeys and verify that the clicks shown in the heatmap align with the recorded sessions.LBKS5. **Troubleshoot Issues**
- If you don’t see expected data, double-check your initialization code and ensure Session Replay is enabled.
- Use debug tools (like enabling debug mode in the SDK) and browser developer tools to confirm events are being sent to Mixpanel [Debugging: Validate your data](https://docs.mixpanel.com/docs/tracking-best-practices/debugging#before-you-debug).LBKSBy following these steps, you can confidently verify that Mixpanel Heatmaps are working as intended.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.
Let me check the knowledge base for you again. One moment! 📚
To check a Mixpanel heatmap for pages other than the homepage: 1. Go to the Heatmaps section in Mixpanel.
2. Choose the specific URL you want to analyze. You are not limited to the homepage—you can enter any URL for which you want to generate a heatmap.
3. Use wildcard selectors (**) in your URL if you want to group multiple similar pages (e.g., /products/** to analyze all product pages together).
4. Rotate through backdrops to view different states of your application for the same URL, which helps you see heatmaps for various UI states on that page.This allows you to analyze user interactions on any page, not just the homepage, and ensures you can validate heatmap data across your site Using Heatmaps.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.
Let me check the knowledge base for you again. One moment! 📚
You should enter the wildcard URL (e.g., /products/**) directly in the Heatmaps section of the Mixpanel UI when you are choosing the URL to analyze. This allows you to group and analyze user interactions across multiple similar pages (such as all product pages) in a single heatmap view.The documentation states: > You can use wildcard selectors (**) in your URL to group multiple pages into a single heatmap. For example, if your URLs contain unique IDs like /products/123 and /products/456, you can use /products/* to analyze all product pages together Using Heatmaps.So, when prompted to select or enter a URL in the Heatmaps section, input your wildcard pattern there.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.
Let me check the knowledge base for you again. One moment! 📚
If Heatmaps and Session Replay are enabled but not showing on the homepage (while you can confirm Session Replay is working through other means), possible root causes based on the knowledge sources include: 1. Limited Replay Coverage
Heatmaps only capture data during sessions with recorded replays. If there are few or no session replays for the homepage, the heatmap may not display meaningful data or may not appear at all. Ensure that enough sessions are being recorded on the homepage to generate heatmap data Heatmaps for Web.2. Session Replay Not Active on Homepage
Even if Session Replay is working elsewhere, it may not be active on the homepage due to sampling settings or manual stopping of session recording (e.g., via mixpanel.stop_session_recording()). Make sure session recording is not being disabled on the homepage Session Replay Privacy Controls.3. Incorrect Initialization or Configuration
Double-check that the Mixpanel SDK is initialized correctly on the homepage, with both Session Replay and Heatmap data collection enabled. If the initialization code is missing or misconfigured on the homepage, no data will be collected Heatmaps for Web.4. Ad Blockers or Browser Settings
Ad blockers or certain browser privacy settings can prevent events and replays from being sent to Mixpanel. Try disabling ad blockers and ensure browser settings allow tracking Track Events FAQ.5. Data Residency or API Host Issues
If your project uses a specific data residency (US, EU, India), ensure the SDK is configured to use the correct API host. Otherwise, events may not be sent to the right project Debugging: Validate your data.6. Retention or Sampling Settings
If your session replay sampling rate is low, you may not capture enough sessions on the homepage. Consider increasing the sampling rate to ensure more sessions are recorded Heatmaps for Web.If you have confirmed that Session Replay is working elsewhere and your implementation is correct, but the homepage still does not show heatmaps or replays, review the above points and check your implementation and sampling settings specifically for the homepage.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.
Let me check the knowledge base for you again. One moment! 📚
Yes, you can use your own account to generate clicks and test the heatmap feature in Mixpanel. The documentation recommends manually triggering events on your own device to validate that data is being captured correctly. After interacting with your site (e.g., clicking on elements), you can check the Events feed in Mixpanel to confirm that the relevant click events are being recorded. This approach is commonly used to validate event tracking and ensure that features like heatmaps are working as expected Debugging: Validate your data.Keep in mind that heatmaps are powered by session replay data, so your clicks will only appear in the heatmap if they occur during a recorded session. Make sure session replay is enabled and active while you are testing Heatmaps for Web.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.