By default, heatmap snapshots are automatically taken on page load. With the release of plugin version 5.1.0, you can now capture the snapshot manually.

Note: If you have excluded your IP address in Matomo (in global or website settings > Excluded IPs), manual heatmap capture will not work. To test or trigger heatmap recordings manually, temporarily remove your IP address from the exclusion list.

To capture the snapshot you need to follow below steps:

  • Add or Edit the heatmap you want to capture the snapshot manually.
  • Enable Capture Heatmap Snapshot Manually.

  1. Click Add/Update.
  2. Copy the command (_paq.push(['HeatmapSessionRecording::captureInitialDom', {idHeatmap}])) mentioned in the helptext for the Capture Heatmap Snapshot Manually option.
  3. Execute this command manually to capture the snapshot when your page has loaded completely.

Note: By enabling Capture Heatmap Snapshot Manually, the existing snapshot will be deleted and you would need to run the _paq.push(['HeatmapSessionRecording::captureInitialDom', {idHeatmap}]) command in your browsers developer tools console to recapture the snapshot.

Previous FAQ: Is there any data limit to how heatmaps can be generated or how many sessions can be recorded?