Skip to content

Commit 76642b0

Browse files
authored
docs: add callout explaining sessions vs session replay distinction
1 parent 5a954b2 commit 76642b0

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

contents/docs/data/sessions.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,17 @@ A session is a set of events that try to capture a single use of your product or
2424

2525
Sessions enable you to analyze how exactly users are using your product, their entry and exit points, how long they spend on your site, how active they are, bounce rate, and more.
2626

27+
<CalloutBox icon="IconInfo" title="Sessions vs Session Replay" type="fyi">
28+
29+
**Sessions** and **Session Replay** are related but distinct concepts:
30+
31+
- **Sessions** - An analytics concept where events are grouped by `$session_id` to represent a single visit. Used for metrics like session duration, bounce rate, and entry/exit paths.
32+
- **Session Replay** - A visual recording feature that captures what users actually did during a session, including DOM changes, mouse movements, clicks, and scrolls.
33+
34+
Not every session has a recording. Session Replay must be [enabled separately](/docs/session-replay/installation) and has its own [billing limits](/docs/session-replay/how-to-control-which-sessions-you-record#billing-limits). You can use session analytics without Session Replay, and vice versa.
35+
36+
</CalloutBox>
37+
2738
## How does PostHog define a session?
2839

2940
Our [JavaScript Web library](/docs/libraries/js) and mobile SDKs (Android, iOS, React Native, and Flutter) add a `$session_id` property to each event. Events captured from the same user, browser, and device get the same `$session_id` within the same session, until a new session is started. A new session is started by default when either there's **no activity for 30 minutes** or the session has reached the maximum session duration of 24 hours. Subsequent events are grouped into a new session and a new session triggers a new session replay.

0 commit comments

Comments
 (0)