Troubleshooting Heatmaps & Session Recordings

If you are experiencing issues with Heatmaps or Session Recordings, first verify that the Heatmap or Session Recording settings are correctly configured, including tracking setup, target URL matching, and consent configuration.

Next, review the troubleshooting FAQs below that cover common causes for tracking issues, screenshot generation, missing styles, CORS errors, and conflicts caused by custom styling.

If the problem persists, contact Matomo Support for further assistance and include deatils of the issue, your website URL, and any troubleshooting steps already completed. This helps resolve the issue faster.

Troubleshooting articles for Heatmaps

• Why does the Heatmap screenshot not show the fully rendered page (pictures or content missing)?
• Blank Heatmaps. Matomo is not recording any Heatmaps or Sessions?
• Why do I have heatmap samples but no screenshot?
• Will the generated heatmap still work if I change a web page while heatmap data is collected?
• What can I do if the heatmap or session recording is not styled and CSS or font icons seem missing?
• Fix CORS issue for Heatmap and Session Recording
• Will the generated heatmaps and recorded sessions still work even if I remove the page on my website?
• Is there a maximum page height for heatmaps?
• Apply custom stylesheets when a heatmap is generated or a session recording replayed
• Correct a heatmap when a page header is shown over the full heatmap
• Configure Matomo to not load CSS from db