Review recording controls and set the retention period available to your workspace.
Plan requirement: Session Replay requires Scale or Enterprise. It is also available during an active trial. A workspace-specific Session Replay override can make it available on another plan.

Open the Session Replay settings

  1. Confirm that you are working in the correct workspace and project.
  2. Open Session Replay.
  3. Open the privacy settings dialog.

Session Replay settings showing recording, retention, audience, and volume controls

The Session Replay configuration covers privacy modes, sampling, quota, targeting, recording access, and retention. Review these settings for the selected workspace before turning on recording for a paid plan.

Turn recording on

  • Active trials record automatically and do not require a separate opt-in.
  • Scale, Enterprise, and legacy Pro workspaces must turn on Session Replay before new sessions are recorded.

Plan access and recording status are separate for paid workspaces. A workspace can have access to Session Replay without recording being turned on.

Choose who can be recorded

Under Audience, choose one option:
  • All users allows identified and anonymous users to pass sampling.
  • Saved segment limits eligibility to identified users in the selected segment.

Audience eligibility is evaluated before sampling and the daily quota.

Control recording volume

  • Sampling is the percentage of eligible analytics sessions that load the recorder. Set it
from 0% to 100%.
  • Daily quota is the maximum number of logical sessions accepted for the project in one UTC
day. The quota is the final ceiling after sampling.
Use a lower sampling percentage when you need representative coverage without recording every eligible session. Use the daily quota to cap the maximum daily volume.

Choose a privacy mode

Privacy settings apply to new recordings and do not rewrite existing replays.
  • Selective masking records interface text, masks form values, and redacts the selected PII
types. This is the recommended default.
  • Mask everything masks all text and form values.
  • Record everything records visible text and form values. Passwords and elements matched by
your mask selectors remain protected.
With Selective masking, choose whether to redact email addresses, phone numbers, payment card numbers, and IP addresses from page text. Form values remain fully masked in this mode.

Mask or block specific elements

Use comma-separated CSS selectors for either control:
  • Always mask these elements replaces matching text and form values with asterisks.
  • Do not record these elements replaces matching regions with an empty box.

Test selectors in a non-production environment before relying on them for sensitive data.
Select Save settings after reviewing recording access, audience, volume, privacy, and retention.

Understand retention

| Workspace access | Retention | | --- | --- | | Active trial | 30 days | | Scale or legacy Pro | 90 days | | Enterprise | 90 days by default, or a custom period from 1 to 3,650 days |
Custom retention is available only on Enterprise.

What happens when retention changes

A replay receives its expiry when recording begins. Changing the retention setting affects new recordings; it does not recalculate the expiry of replays that already exist.

Troubleshooting

You cannot open Session Replay settings

Check the selected workspace under Settings → Billing. Session Replay requires an active trial, Scale, Enterprise, legacy Pro access, or a workspace-specific override.

New replays are not being recorded on a paid plan

Open the privacy settings and confirm that Session Replay is turned on. Paid plan access alone does not enable recording.

Existing replays still use the previous retention period

This is expected. Existing replays keep the expiry assigned when recording began; the updated retention period applies to new recordings.

Was this helpful?