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.
Manage Session Replay settings
Use Session Replay settings to control which projects capture replays and heatmap data, manage your capture quota, and choose privacy controls. Use these settings to adjust an existing implementation. To start capturing replays, first install the Session Replay browser plugin.
Open Session Replay settings
Admins and managers can view or modify settings for projects they have access to.
- Go to Settings > Organizational Settings > Session Replay Settings.
- Review your organization's replay capture allowance and current usage.
- Find the project you want to configure. The project list shows capture toggles, sample rate, instrumentation status, masking level, and masking overrides.
- Select the project to open its sampling, masking, and console tracking controls.
Control replay and heatmap capture
Use the project list to enable or disable session capture and heatmap capture for each project.
Heatmaps aggregate web Session Replay interactions into maps of clicks, element interactions, and scroll depth. Enabling heatmap capture controls data collection; to check SDK requirements and build a map, follow Create a heatmap. Replay sampling limits the interactions available to heatmaps, so consider heatmap coverage when choosing a sample rate.
After you change capture settings, verify capture. If the SDK sends replay requests but replays don't appear, use Monitor replay ingestion to check request statuses.
Choose sampling and targeting
In the project's Sampling control, choose how to distribute your replay capture quota:
- Use manual sampling to capture a fixed percentage of sessions.
- Use dynamic sampling to adjust rates daily across participating projects.
- Use targeted capture to capture sessions that match events, properties, or URLs.
For quota calculations and configuration requirements, follow Configure Session Replay sampling. To check capture volume after changing rates, measure captured replays.
Configure masking
In the project settings, choose a masking level and define overrides for individual page elements. Follow Manage privacy settings for Session Replay for masking presets, CSS selectors, and precedence between SDK and organization settings.
Masking controls page text and form inputs. To protect sensitive content in URLs, configure URL filter rules. To determine when to start capture based on consent, follow Manage user consent.
Configure console tracking
Capture console information when you need to investigate an error alongside the user's actions.
- Go to Settings > Organizational Settings > Session Replay Settings.
- Select the project you want to configure.
- In Console Tracking, enable or disable console tracking.
- Select the types of console information to capture:
Info,Log,Warn, andError.
To investigate the captured logs alongside network requests and replay activity, follow Inspect replay errors.
Was this helpful?