For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
Install Session Replay
Install Session Replay to record user interactions and investigate the behavior behind your analytics events. Standard analytics instrumentation alone doesn't capture replays.
Start with your platform's Unified SDK to install Analytics and Session Replay together with shared configuration. Use the installation and replay configuration links below, then complete setup to verify a recording.
Plan your implementation
Before production capture, decide how to manage consent and mask sensitive content. Your SDK guide covers the privacy controls that apply to your platform.
Install the recommended Unified SDK
Choose your platform, follow its installation and initialization instructions, then configure Session Replay capture:
| Platform | Recommended installation | Replay configuration |
|---|---|---|
| Browser | Browser Unified SDK | Set Session Replay options |
| Android | Android Unified SDK | Configure Session Replay |
| iOS | Unified SDK for Swift | Configure Session Replay |
| React Native | React Native Unified SDK (beta) | Configure the Unified SDK |
For Flutter, follow the Flutter Session Replay standalone SDK guide.
Add replay to an existing integration
Use a plugin when you want to keep your existing Amplitude Analytics SDK installation. Use a standalone SDK when you use another analytics provider.
Browser alternatives
| Your setup | Implementation guide |
|---|---|
| You already use Amplitude Browser SDK 2 | Browser plugin quickstart |
| You use a different analytics provider | Browser standalone SDK quickstart |
| You instrument Amplitude with Google Tag Manager | Install with Google Tag Manager |
Mobile alternatives
| Platform | With an existing Amplitude Analytics SDK | Without an Amplitude Analytics SDK |
|---|---|---|
| Android | Android plugin | Android standalone SDK |
| iOS | iOS plugin | iOS standalone SDK |
| React Native | React Native plugin | React Native standalone SDK |
If you use Segment's Amplitude (Actions) destination for React Native, follow the React Native Segment integration.
Third-party integrations
| Analytics provider | Implementation guide |
|---|---|
| Segment | Segment wrapper to choose the integration path for your site |
| RudderStack | RudderStack integration |
Complete setup
After installing your SDK or integration:
- Configure privacy settings and the platform-specific masking controls in your SDK guide.
- Choose a session matching option to connect replays with analytics events. Default Amplitude sessions match automatically. For event-property session definitions, configure custom session matching. For pipelines without session IDs, configure time-based matching.
- Set a sample rate. Use targeted capture if you need conditional capture.
- Verify capture with a test session before production rollout.
Self-hosting is optional when you need to serve browser scripts or proxy requests through your own domain.
Was this helpful?