Charts - Docs

There are ten charts and visualization options in trends. They're split into two categories:

• Time series, which show you how tracked events and data points fluctuate over a time period.
• Total value, which show the total number of tracked events or data points in any given time period.

Time series

Line chart (linear)

The line chart is a simple, linear trend plot with time on the X-axis and each data point corresponding to the grouping value you've chosen.

Additional series or breakdowns you add to a line chart will appear as separate lines on the chart.

Line chart (cumulative)

The cumulative plot displays a running tally of each series over the given time period.

This is useful for understanding how quickly an event or data point is growing, such as whether the number of people signing up for your product is growing exponentially or leveling off.

Bar chart

The time series bar chart displays the value of a series over time. This plot shows the exact same information as the linear chart, but in a slightly different visual manner.

Additional series or breakdowns you add to a bar chart will appear stacked, so you can see how much each property or series contributes to the total number.

Area chart

Area charts are a twist on the line chart. When you add a breakdown, or multiple series, area charts behave like a stacked bar chart, but render the data in a line chart showing how each data point contributes to the total. Like line charts, smoothing (7-day or 28-day rolling average) is available when data is grouped by day, hour, or minute.

Box plot

The box plot displays the statistical distribution of a numeric property's values over time. Each box shows:

• Min – the minimum value
• 25th percentile (Q1) – the value below which 25% of observations fall
• Median – the middle value (50th percentile)
• Mean – the average value
• 75th percentile (Q3) – the value below which 75% of observations fall
• Max – the maximum value

Box plots are useful for understanding how the distribution of a metric changes across time intervals and for spotting outliers.

Box plots require you to select a numeric property (such as $session_duration or a custom numeric property). Breakdowns and formulas are not available for box plots.

Exclude outliers

When your data contains extreme outliers, they can stretch the y-axis and make it difficult to see differences between the quartiles. To improve readability, enable Exclude outliers in the chart's Options menu.

When enabled, whiskers are clipped using the standard 1.5× IQR (interquartile range) rule:

• Lower whisker – extends to the smallest value within Q1 - 1.5 × IQR
• Upper whisker – extends to the largest value within Q3 + 1.5 × IQR

This option is enabled by default. Disable it to show the full data range including outliers.

Total value

Number

Shows a single value for the selected event or data point during the given period. Use the Headline value setting in display options to choose what value to show:

• Total - The sum of all values in the period (default)
• Average - The mean of all values in the period
• Latest - The most recent value in the period

Enable Compare to previous period to show a percentage change pill. How the change is calculated depends on your headline value setting:

• Total or Average - Compares against the previous period when "compare to previous" is enabled, otherwise shows the change from first to last point
• Latest - Always shows the change from first to last point in the current period

Hover over the sparkline to see individual data point values and point-to-point changes.

This chart type is only available when there's a single series (or formula) and no breakdowns added to the insight.

Bar Chart

Displays the total value of a series over the entire date range. This means that this type of plot has no option for grouping, as it doesn't display data over time.

Try using a breakdown in combination with this chart type to see a list of the top property values, or add multiple series to see how they compare.

When using breakdowns with this chart type, each breakdown value displays as a separate bar by default. To combine breakdown values into stacked bars grouped by series, enable Stack breakdown values in the display settings. This is particularly useful when using formulas with breakdowns, as it lets you see the breakdown composition within each formula result.

Table

The table view displays the raw numerical values of a series over the entire date range.

When you enable Compare to previous period, comparison values appear in a dedicated column next to the current values, making it easy to compare them side-by-side.

Pie

The pie chart shows the relative distribution of the values of different series or breakdowns over the entire date range.

You can customize the pie chart appearance in the display settings:

• Slice content – Choose what to display on each slice: labels (default), values, or none.
• Value format – When showing values on slices, display them as absolute amounts or as percentages of the total.
• Show total – Toggle the aggregation total displayed below the chart (on by default).

World map

The world map chart displays values in an interactive map of the world, broken down by country code. This display option can't be selected if you're already breaking down by a property other than country code.

Calendar heatmap

The Calendar heatmap insight displays a heatmap showing either the number of unique users or total events for any selected event, broken down by hour of the day and day of the week.

What the heatmap shows

• Each cell represents the number of unique users or total events during a specific hour of a specific day. Numbers are formatted for readability (e.g., 1.73K for 1,730).
• The "All" column on the right aggregates the total for each day across all hours, and is highlighted in a different color.
• The bottom row ("All") aggregates the total for each hour across all days, also highlighted in a different color.
• The bottom-right cell shows the grand total for the selected metric (unique users or total events) across all days and hours in the selected time range, with a distinct color.
• Use the "Show more" button to expand the heatmap and view additional details if available.
• The displayed time for each cell and the starting day of the week are based on your project's date and time settings. By default, the time is UTC, but you can change the timezone in your project settings.

Note: Selecting a time range longer than 7 days will include additional occurrences of weekdays and hours, potentially increasing the counts in those buckets. For best results, select 7 closed days or a multiple of 7 closed day ranges.