Overview
Replays list: columns, empty states, issue-scoped filters, live sessions, and how to open the player.
What is a replay?
A session replay reconstructs what a visitor saw and did (pages, clicks, scrolls, etc.). It is not a webcam video of the person.
Route: /projects/:id/replays
Sidebar: Replays
Page layout
| Region | Purpose |
|---|---|
| Top bar | Same filter/date/refresh/live-users chrome as Dashboard |
| Scoped chip | Appears when deep-linked from an issue or replay set |
| Left list (~320px) | Sessions to open |
| Right player | Opens when you select a session — see Player |
How to open a replay
- Optionally set date range / filters (same system as Dashboard).
- Click a row in the left list.
- Use the player controls on the right.
- Close player to return focus to browsing.
Deep links (URL query params)
| Param | Meaning |
|---|---|
replay=:id | Open this replay in the player |
issue=:issueId | Scope list to replays linked to an issue |
sessions=… | Scope to a replay set |
t=:epochMs | Seek player to an absolute time (epoch milliseconds) |
shared range / filters | Same as other analytics pages |
When issue or sessions is set, a chip appears like Issue / Replay set · is · N matching replay(s) with Remove replay filter.
Gotcha: replay / issue / sessions / t are page-specific so list paging does not constantly reset them.
Live vs archived
- Live / processing rows may poll about every 15s.
- Live sessions use a streaming player path; archived sessions use the standard session player.
- Heartbeats from the SDK power “someone is here now” style presence.
Empty & error states
| State | Copy / controls | Meaning |
|---|---|---|
| SDK not connected | No replays yet · Install Human Behavior · More options → View demo, Book a call | Install first |
| Connected, none yet | No replays yet / Sessions will appear here once recorded. | Generate traffic |
| Error | Retry | Transient failure |
| Loading | List skeletons; infinite scroll spinner | Wait / scroll |
Privacy warning (beginners)
Replays can show on-screen text. Configure redaction before recording sensitive apps (healthcare, passwords, secrets).