Overview

The sessions page is a list of sessions in reverse chronological order. From here, you can browse sessions or apply filters to find the specific sessions that are most interesting to you.

To get started, navigate to Sessions from the main menu.

This view is useful for:

• Finding and watching session replays, if you have session replay enabled.
• Finding a particular session where a bug or error may have occurred. Find out what happened in the session, either with session replay or with the Heap autocaptured event list.
• Digging into a particular session of interest to better understand what a user did on your site.
• Browsing recent sessions to get an overall better understanding of what users do on your site.

Filtering on the Sessions page

You can use filters to find interesting or relevant sessions, including:

• Filter by event: Only show sessions where a certain event occurred.
  • Session or event-level property filters on top of an event: Further filter your results (ex: sessions where a certain event occurred, where the browser equals Chrome, or IP address equals X). Click the filter icon next to the event to open the Event Filters popup. 

• Filter by users: Only show sessions from users who match certain criteria (ex: identity contains X, or user is in segment Y).
• Date range: Only show sessions from certain time periods.

Accounts that have purchased session replay can filter by sessions with replays. Toggle on Only show sessions with replays to limit your search to sessions with replays.

Events within a session

Once you’ve found an interesting session, click View events to see the events that happened during that session.

Hover over an event to highlight all instances of it. Labeled events are shown with their names, while unlabeled events have the raw event name as the title. The number next to each event title in the Most frequent section tells you how many times that event happened during the session.

Click on an event to see all the associated event criteria. By default, Heap captures event properties such as path and domain, though other criteria such as screen dimensions can be included using snapshots.

For a full description of the user properties Heap captures by default, see our list of Autocaptured Data.

Watch session replays

If a replay is available for a particular session, a play icon will appear next to it. Click the icon to watch the session.