Targeted Replay Capture

Targeted Replay Capture (TRC) is a per-project feature in Amplitude Session Replay that lets you capture session replays based on specific criteria rather than capturing all sessions or relying on random sampling. Focus your replay quota on the most important user behaviors, workflows, or segments.

Configure Targeted Replay Capture by adding conditions to the Sampling control in your project's Session Replay settings. Customize capture criteria with specific conditions like multiple events, event properties, or user properties. Combine criteria within a single filter or across filters with OR logic. The Session Replay SDK fetches targeting configurations from a remote config service and evaluates them at runtime to decide whether to capture a session.

Key capabilities

TRC enables you to define the criteria that Amplitude uses to decide to capture a session, and more efficiently manage your Session Replay quota.

Custom capture criteria

Define rules that capture replays based on:

• Specific events: For example, Checkout Started.
• Event properties: For example, plan = Pro.
• User properties: For example, country = US.
• Combinations: Combine these criteria with OR logic.

Configuration and quota management

Manage TRC through the Session Replay settings page by adding conditions to the Sampling control. Add, edit, and remove targeting conditions for each project. The UI estimates how much quota each condition uses based on historical traffic. Set different sample rates for different conditions to control which sessions you capture and how much quota you use.

Use cases

• Capture replays only for users who encounter errors or drop off at key points.
• Focus on high-value user segments or critical product flows.
• Reduce noise and cost by avoiding unnecessary replay capture.

Prerequisites

Before you configure Targeted Replay Capture, ensure you meet these requirements:

• You're using the Session Replay Browser SDK Plugin version @amplitude/plugin-session-replay-browser@1.22.0 or higher. TRC doesn't work with the standalone SDK.
• You have the appropriate permissions to manage settings in your org and project. For more information, review Manage Session Replay and Heatmap settings.

Configure Targeted Replay Capture

You configure Targeted Replay Capture per project. To configure it:

1. Navigate to Settings > Organizational Settings > Session Replay Settings. For more information, review the Session Replay settings page.
2. Select the project you want to configure.
3. In the Sampling section, select Add Condition to create a new targeting condition.
4. Define your targeting criteria for the condition.

Add multiple conditions and combine them with OR logic. Each condition can include:

• Event types.
• Event properties.
• User properties.

SDK support

TRC requires the Amplitude Browser Analytics SDK with the Session Replay Browser SDK Plugin version @amplitude/plugin-session-replay-browser@1.22.0 or higher. Integrate both the Amplitude Browser Analytics SDK and the Session Replay Plugin into your setup to use TRC.

Evaluation timing

The SDK fetches the targeting configuration at session start and uses it for the entire session. If an event matches later in the session, the SDK evaluates it against that original configuration. Updates to targeting rules apply only to new sessions.