# Session replay

Record user sessions for replay in Screeb, and start or stop the recording from your code when the workspace settings are not enough.

Session replay records what users see and do in your app, Screeb surveys and messages included, so you can watch the session in the Screeb admin. Once the SDK is installed, you turn it on and choose when recording starts in the workspace settings: see [Configure session replay recording](https://help.screeb.app/observe/session-replay-settings/). No code is needed for that.

Write code only when the start conditions of the settings cannot express your case, for example to record a checkout flow from its first step.

## Requirements

- Session replay of mobile apps is in beta. Turn on the recording of mobile apps in the session replay settings of the workspace.
- It needs version 3.0.0 or later of the Screeb iOS and Android SDKs, which the cross-platform SDKs embed, and 3.1.1 or later to start and stop the recording from your code.

## Start and stop the recording

Starting the recording fails when session replay is off in the workspace settings.

```tsx
import { sessionReplayStart, sessionReplayStop } from "@screeb/react-native";

// Start recording
await sessionReplayStart();

// Stop recording
await sessionReplayStop();
```

> [!NOTE]
> Session replay is off, and cannot be turned on, while the workspace runs in consent exemption mode: see [Consent exemption](https://developers.screeb.app/sdk-react-native/consent-exemption).

## Privacy

Mask or exclude sensitive elements with the [Privacy helpers](https://developers.screeb.app/sdk-react-native/privacy-helpers), and see [Session replay privacy](https://help.screeb.app/observe/session-replay-privacy/) for the workspace options.

On mobile, Screeb also masks password fields, and views whose identifier or accessibility label contains a sensitive word such as `password`, `card`, `cvv`, `pin` or `ssn`.

## Battery usage

Session replay adapts to the app activity and to the device. It works less while the app is idle, and under Low Power Mode, Battery Saver, thermal pressure or memory pressure. It lowers image quality, resolution and the processing of changed regions first, and the capture rate of active screens last.
