Enabling session replay, sampling rates, and most privacy settings are managed server-side on the Application Settings page in New Relic so that updates are not dependent on the deployment and adoption of a new app version. Only some types of masking overrides need to be managed in your code.
Requirements and compatibility
Before setting up session replay, ensure your app meets these requirements.
Technical prerequisites
To use session replay, you need:
- A New Relic account with mobile monitoring enabled
- An active mobile application configured in New Relic
- Network connectivity from your mobile app to New Relic's data ingestion endpoints
Minimum agent versions
Below are the first agent versions that supported basic session replay capture:
- iOS agent v7.5.10 released Sept. 15, 2025
- Android agent v7.6.8 released July 29, 2025
- React Native agent v1.5.10 released Sept. 15, 2025
Enable session replay
- Go to one.newrelic.com > All Capabilities > Mobile.
- Select your mobile app.
- In the left-hand menu, click Settings > Application.
- Toggle on Mobile Session Replay.
Configure sampling rates
Define the sampling rates to control how often session replays are captured. Sampling rates can be as small as one millionth of a percent for high throughput apps.
Set a sampling rate for the following:
- User sessions: Records a random sample of all user sessions.
- Errored sessions: Records a random sample of sessions where at least one error occurs. The agent buffers a sliding window of data for up to 30 seconds on the client side. When an error occurs, the buffered data will be uploaded and the remainder of the session recorded. Errors include crashes, ANRs, and handled exceptions. If an error doesn't occur, the replay is never harvested.
For example, if you set the session sampling rate to 50% and the error sampling rate to 100%:
- Half of all user sessions will be recorded.
- All errored sessions will be recorded, even if they're not part of the 50% sample.