Session recording and heatmaps
Session recording captures what a visitor actually did on your PWA — every page, tap, scroll and mouse move — so you can play it back later like a video. The same recordings also feed the heatmaps, which aggregate all visitors into a single picture of where people click, how far they scroll, and where the cursor lingers.
Use it to see why a landing under-converts: a replay shows you one person's path step by step, while a heatmap shows the crowd's behaviour at a glance.
Recording is turned off by default and is enabled per app. Once it is on, recordings appear in two places: on the Replay tab of a single visitor's card, and as a Heatmap tab on the app's card.
How to enable recording
Recording is controlled by one toggle in the PWA editor.
- Open the app's card and go to the Constructor tab.
- Scroll to the Store section.
- Turn on the Record sessions toggle.
- Press Save.
From this point on, new visitors to the app are recorded. Existing recordings stay available; visitors who came before you enabled the toggle were not captured.
The Record sessions toggle sits in the Store section of the editor, next to Verified and Editor's choice. For the full field-by-field breakdown of the editor, see PWA editor.
Watch a session replay
A replay belongs to a single visitor. You open it from that visitor's card.
- Open the Visitors tab and click a visitor to open their card.
- On the card, open the Replay tab.
- The visitor's recorded sessions are shown as buttons at the top. Each button shows the start time, the duration in seconds, and the number of events. The most recent session is selected automatically.
- Use the player controls under the buttons:
- Play / Pause — start or pause playback.
- Restart — play the session again from the beginning.
If a visitor has no recordings, the tab shows No session recordings. A session that is too short to play back shows Recording too short to replay — this usually means the visitor left almost immediately.
A visitor can have more than one session. Switch between them with the session buttons; each one replays independently.
Read a heatmap
A heatmap aggregates every recorded visitor of one app into a single overlay drawn on top of the app's page. You open it from the app's card.
- Open the app's card.
- Open the Heatmap tab.
- Choose what to display with the mode buttons above the page:
- Clicks — where visitors tapped or clicked. The hotter (redder) the spot, the more interactions there.
- Scroll — how far down the page visitors scrolled, showing where most people stop reading.
- Moves — where the cursor moved and hovered.
- The heatmap reflects the period selected for the app's card. Change the period at the top of the page to look at a different range.
If there is not enough data for the chosen period, the tab shows Not enough data for the selected period. Switch the period or wait for more traffic to accumulate.
Start with Clicks to find the elements people actually tap, then switch to Scroll to check whether your install button and key text are above the point where most visitors stop scrolling.