Retention is a type of insight that shows you how many users return during subsequent periods.
They're useful for answering questions like:
- Are new sign ups coming back to use your product after trying it?
- Is a new feature or user experience improving retention?
- What type of user retains the best?
Retention insights are also a vital tool for evaluating whether you've achieved product-market fit.
Creating a retention insight


Retention insights support both events and actions.
When you create a retention insight, you're defining two things:
- A start event – an event or action that determines if the user should be included in the retention analysis.
- A return event – an event or action that the same user/entity 'returns' to perform. This tells us if the user was 'retained'.
It often, but not always, makes sense to use the same event or action for both.


In the example above, we used an action called 'Product Interactions' for both. The start event is highlighted in blue and the return event in green. We grouped users by 'Unique users' and chosen users who did the 'Product Interactions' action for the first time during a six-week period.
You can also:
Analyze retention for groups of users, such as all users in the same organization, company, or account. This is useful if your customers are companies with many users, but not all of them are active. This requires group analytics.
Define the retention period by any number of hours, days, weeks, or months. To analyze retention across a whole year, for example, you should configure your insight to say "in the last 12 months".
Filter your retention insights using filter groups, such as event properties (country, device, etc.), person properties (job title, company name, etc.), feature flags (users who have a flag enabled), and existing cohorts (pre-defined groups of users).
Choose between first time retention and recurring retention. Recurring retention counts a user as part of a cohort if they performed the start event during that time period, irrespective of it was their first time or not. First time retention only counts a user as part of the cohort if it was their first time performing the start event.
Add breakdowns to see how retention varies across different user segments. For example, you could break down by country to see which regions have the highest retention rates.
Select between two retention reference options: "Period 0" (default) and "Previous period". The reference determines how percentages are calculated - either relative to the initial cohort or the previous period.
Choose between weighted mean (default) and simple mean for retention calculation. Weighted mean accounts for different cohort sizes when calculating the average retention, while simple mean treats all cohorts equally.
Understanding retention insights
Retention insights are visualized in two ways:
- A retention graph, where each cohorts retention is rendered in a comparable line graph.
- A cohort retention table, where the same data is shown in a table.


By default, both show the percentage of users who retained in each cohort relative to 'Week 0'
Column A denotes the cohort. This retention insight is grouped by week, so it shows the date range of the six most recent weeks, and the seventh currently incomplete week.
Column B shows the size of each individual cohort. As noted earlier, retention insights default to unique users, but they can also be grouped by unique organizations, companies, etc.
Column C is 'Week 0' – i.e. the week in which the start event or action first took place. This is always 100% because all users in that cohort must perform the event to be included. This would be 'Hour 0', 'Day 0', or 'Month 0' if you choose a different time period.
Column D is Week 2 – i.e. the second week after the cohort was created. In this example, 27.4% of the 'May 20 to May 26' cohort retained, or 372 users.
When analyzing retention insights, remember that:
Users cannot exist in more than one cohort – i.e. a user in the 'May 20 to May 26' won't also appear in the 'Jun 3 to Jun 9' cohort.
Users can appear in more than one retention period – i.e. they could be counted in both 'Week 1' and 'Week 3', or all six weeks. This means, for example, that it's possible for a later period to have higher retention than an earlier period. This could suggest that users tend to return in a regular pattern – i.e. every few weeks or days – to perform a specific task.
Retention insights only show you whether users performed an action or event, not how often. For that, create a stickiness insight.
Periods in progress are marked with a tooltip indicating they're not yet complete. These periods will update as more data comes in.
Clicking on a retention cell opens a modal with details about the specific users retained in that period, allowing for deeper analysis.
Advanced retention options
Relative retention
By default the retention percentage show in each cell is based off of 'starting cohort size' (the total number of users/entities that performed the start event which is indicated in the 'size' column). So if Day 2 shows 25% for a cohort, it means that 25% of the users who performed the start event returned on Day 2.
You can toggle this to show retention relative to 'previous period'. This changes the retention calculation to be the percentage of users who returned compared to the previous period. With this option if Day 3 shows 40%, it means that 40% of the number of users who returned on Day 2 returned on Day 3. The option helps to see which time interval has the biggest percentage increase/drop offs in users.


Retention criteria
By default the retention numbers for a specific time interval, say Day 2, include only users who returned (performed 'return event') on Day 2. This on retention is useful when you feature requires users to come back in each and every time interval.
An alternative to this is the on or after criteria. Also know as 'cumulative', 'rolling' or 'unbounded' retention. When this is enabled, the retention number for a specific time interval, say Day 2, includes user who returned on or after Day 2 (i.e. users who returned on Day 3, Day 4,... are also counted in Day 2). On or after retention provides an absolute view of how effectively you keep users coming back. It shows how many people first used your product and eventually returned to find more value, essentially highlighting the inverse of your overall churn rate. This is useful when you want to measure your features which don't require users to come back consistently in every time period and gives you signal if they still care about the feature.
Mean calculation logic
You can choose between two different calculation options for the mean/average retention for each time interval.
- 'simple' - Calculates the average retention rate across all cohorts by giving equal weight to each cohort, regardless of its size.
- 'weighted' - Calculates the average retention rate by giving more weight to larger cohorts, accounting for different cohort sizes in the final mean.
Breakdowns
You can breakdown your retention numbers and graph on event/person properties. eg. Breaking down the retention numbers by 'Country Name' can help to see which countries/regions have higher retention for the feature.
When using breakdowns you see the mean retention for each breakdown value and can click on each row to expand and show each cohort with that breakdown value. There is also a dropdown selector next to the time range filter which lets you filter the graph and table for a specific breakdown value.
Note, the breakdown logic is implemented such that both the start and return event must have the same breakdown value. Example, when breaking down by browser, if the user performs the start event in Google Chrome but performs the return event in Firefox, the return event won't be counted in the breakdown results for Google Chrome.
Configure display of retention insights on dashboards
Retention insights let you toggle the type of graph you're using. You can select between a 'Line chart' and a 'Bar chart'. Also within 'Options' you can select how the retention insight should show up on dashboards. You can toggle between showing both/one of the retention graph and the retention table.
Retention vs. Stickiness
Stickiness and retention insights can look very similar, but they tell you different things:
- Retention measures the percentage of users who came back and performed an event within a given period at least once
- Stickiness measures how many times within a period a user performed an event
Retention is good for seeing how well you're doing at keeping users engaged overall. Stickiness is useful for seeing deeply users are engaging with your product and helps you identify the most engaged users.