Mobile & responsive sessions
ShieldReplay records mobile interactions with viewport context so replays and heatmaps scale correctly across breakpoints.
Viewport capture
Viewport width and height are stored on cursor and interaction events. Investigator mode uses this to render replays at the correct scale on narrow screens.
Touch vs click
Touch taps are recorded as clicks with coordinates. Rage and dead-click heuristics apply to mobile tap patterns the same way they do for mouse input.
Recommendations
- Test on real devices — mobile Safari and Chrome behave differently for DevTools probes.
- Include the viewport meta tag:
<meta name="viewport" content="width=device-width, initial-scale=1">. - Compare page-level heatmaps across breakpoints in replay investigator mode.
- Add your mobile web origin to allowed domains if it differs from desktop (e.g.
m.example.com).
Performance
The agent batches mutations and uses sendBeacon on unload. For low-end devices, use sampling modes (errors only, probes only, friction only) in Site settings → Recording.
Tip: Use the embed test page on a phone on the same network to verify ingest before production deploy.