---
title: "Chart Builder — Group By"
slug: "chart-builder-group-by"
updated: 2026-04-27T14:42:38Z
published: 2026-04-27T14:42:38Z
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.userflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chart Builder — Group By

## Group By

Group By lets you slice your chart data by any user or company attribute — turning aggregate event data into segmented views that reveal how different user populations behave.

**Example:** Track "Feature Activated" events and group by Plan Type to see whether Pro users activate the feature at a higher rate than Starter users.

### Adding a Group By to a chart

1. Open an existing chart or create a new one using the **Chart Builder**.
2. In the chart configuration panel, click **Group By**.
3. Select the attribute you want to group by — for example, Plan Type, Subscription Status, Region, or any custom attribute you track on users or companies.
4. The chart updates to show a separate line or bar series for each value of the selected attribute.

### Supported attributes

You can group by any user or company attribute available in your Userflow account. Segment class membership (e.g., "In segment: Power Users") can also be used as a Group By dimension.

### Combining Group By with global filters

Group By works alongside global filters. Apply a global filter first to narrow the dataset, then use Group By to break that subset down by attribute. For example: filter to users who completed onboarding in the last 30 days, then group by Plan Type to compare plan-level behavior within that cohort.

### Limitations

- Group By is available on **Usage** charts. It is not available on Funnel charts.
- Charts with Group By applied display up to the top 10 attribute values by volume. Values beyond the top 10 are grouped into an "Other" category.