Overview

The users page in Heap allows you to see granular, user-level data of how people are interacting with your site or app. It presents a list of users in reverse chronological order based on the most recent activity. For each user listed, Heap shows all user properties associated with that individual, as well as all their events grouped by sessions.

To get started, navigate to Users from the main nav in Heap.

Understanding the Users page

By default, you're be shown users with sessions from the past 7 days. The Timeline can be adjusted by clicking on it and selecting a new option from the drop-down that appears. See Filtering the users page below to learn more about narrowing down results based on user properties, segments, or events. 

About this user

Each user’s entry has their unique identifier, which by default is their Heap User ID, though you can replace this with either an email address or another identifier via our Identify API. 

Hovering over the First session date will tell you their location, and hovering over Last session will give you the exact date and time of that session. 

Click View sessions to see the complete list of sessions and a searchable list of user properties associated with this user. Any custom properties sent via our Identify API are available in this list of properties.

For a full description of user properties captured by default, review our list of Autocaptured Data.

Sessions and events

For a given session you can click View events to drill down into the individual events that comprise the session. 

When you hover over a given Most Frequent event, it will highlight all of the instances of that event in the scrollable list below. 

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

Rage clicks are highlighted red:

Creating events from the Users page

If you click on a raw event, Heap presents the event properties as well as an input field to define the event.

Once you click Define, the event will become available in the Users page and all other Heap analysis views.

Web and Web Mobile Events

If you have Heap installed on your website and mobile app and data is being sent to the same environment, sessions to your website and mobile app will appear together in the session history for identified users.

Mobile sessions can be identified by clicking on any event within the session and checking the Source metadata in the event properties pop-up. The source will be either iOS or Android for mobile sessions, even with React Native mobile apps. In contrast, the source for web sessions will always be Web.

Watching 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.

To learn more about session replay, see What is session replay, and how to do I get it?.

Filtering the Users page

Filter your list of users by clicking Add Filter. You can add multiple filters to further narrow your search.

Heap currently supports the following filters in the Users page:

• Time filters (ex: Users seen in the past X days or between Y and Z dates)
• User properties (including Identity)
• Event filters (ex: Users that have done event X)
• Event property filters - (ex: Users have done event X where property Y = Z)

If you use Heap's Identify API to identify your users, you can filter for specific users. Select Identity as the property you want to search for, the operator (such as "contains"), and the identity you are looking for. In the example below, we are searching for our employee Heappo.

Learn more about Using Identify.