Replays
Replays let you watch recordings of real visitor sessions on your website — every click, scroll, and navigation captured as it happened. Use replays to understand how users actually interact with your pages, diagnose confusing UX, reproduce bugs, and validate design changes with real behavioral evidence.
Enabling Replays
Log into Umami and click on Websites in the sidebar.
Click on the Edit button for the website you want to edit.
Navigate to the Replays section and click on the toggle.
| Option | Attribute | Description | Default |
|---|---|---|---|
| Sample Rate | data-sample-rate | Fraction of sessions to record, from 0 to 1. For example, 0.15 records 15% of sessions. | 0.15 |
| Mask Level | data-mask-level | Privacy masking level. moderate masks all input fields; strict masks all inputs and all text on the page. | moderate |
| Max Duration | data-max-duration | Maximum recording length in milliseconds. Recording stops automatically when reached. | 300000 (5 min) |
| Block Selector | data-block-selector | CSS selector for elements to fully exclude from recording (e.g., .sensitive-widget). | none |
You will also need to update your tracker script to opt in to replay collection.
<script
defer src="http://localhost:3000/recorder.js"
data-website-id="my-website-id"
data-sample-rate="0.15"
data-mask-level="moderate"
data-max-duration="300000"
></script>Notes
- Only sessions that start after enabling the feature will be recorded. Existing session history will not be backfilled.
- Session replays are stored for 30 days.
Accessing Replays
Method 1: Replays are accessible from the Replays screen.
Method 2: Replays can also be accessed via the session profile in the Replays tab.
Clicking the play button opens the replay player. The player shows a real-time recreation of the visitor's session, including:
- Mouse movement and clicks
- Scroll behavior
- Page navigations
- Form interactions (inputs are masked by default)
Saving Replays
You can mark individual replays as saved to flag them for quick access and easy rewatching of important sessions.
Open a replay and click the Save button in the player toolbar and give it a name.
Saved replays are flagged and can be accessed in the Saved tab.
