Video-Like Replay
Enhance your Session Replay experience with video-like playback. Configure screenshot quality and capture frequency to see exactly what your users experienced during their sessions.
Overview
Video-like Session Replay transforms your session recordings from simple screen-by-screen captures into smooth, video-like playback. This feature gives you complete visibility into user behavior by:
Capturing more frequent screenshots -> See every interaction, not just screen transitions
Providing configurable quality profiles -> Balance visual fidelity with storage efficiency
Supporting multiple capture modes -> Choose the right approach for your debugging needs
Capturing Modes
Control when screenshots are captured using the Capturing Mode API.
1 - Navigation Mode (Default)
Captures screenshots only when users navigate between screens. This is the default behavior, providing the lowest overhead.
Best for: Apps where screen transitions are the primary user flow
2 - Interactions Mode
Captures screenshots on screen navigation and user interactions. Includes debouncing to prevent excessive captures.
Best for: Debugging user interaction issues, understanding how users interact with complex screensSupported Interactions
UIKit
SwiftUI
Tap
Tap
Double Tap
Double Tap
Long Press
Long Press
Force Touch
Force Touch
Swipe
Swipe
Pinch
Pinch
Scroll
Scroll*
3 - Frequency Mode
Captures screenshots at a fixed time interval for true video-like playback. Also captures on screen navigation.
Best for: Full video-like replay experience, debugging visual issues, understanding complete user journeys
Screenshot Quality
Control the visual quality of captured screenshots. Higher quality provides better visuals but uses more storage.
Quality Profiles
Profile
Compression
Use Case
High
50% quality (WebP)
Detailed debugging, visual regression testing
Normal (Default)
25% quality (WebP)
Balanced quality and storage
Greyscale
25% quality + grayscale (WebP)
Maximum storage efficiency, text-heavy apps
Estimated Screenshots per Session
Based on the default 1MB session screenshot limit:
Quality Profile
Approx. Screenshots per Session
High
~62 screenshots
Normal
~104 screenshots
Greyscale
~130 screenshots
Tip: For video-like replay at 1 FPS with Normal quality, you can capture approximately 1-2 minutes of continuous session activity.
SwiftUI Considerations
For SwiftUI apps, most interactions are captured automatically. However, scroll detection in SwiftUI requires manual gesture handling if you want scroll events to trigger captures in Interactions mode.UIKit views embedded in SwiftUI work as expected with full interaction detection.
→ Please refer to our SwiftUI integration docs for more details SwiftUI Integration for iOS.
Privacy & Masking
Video-like Session Replay respects all existing privacy configurations:
Auto-masking continues to work across all capturing modes
Private views are masked in all captured screenshots
Migration Guide
If you’re upgrading from a previous SDK version:
No breaking changes -> Default behavior remains Navigation mode with Normal quality
Opt-in feature -> Video-like replay must be explicitly configured
Repro Steps unaffected -> Bug and Crash report screenshots continue to use Navigation mode and Normal quality
Last updated