Note: This feature is only available on our paid plan. See our pricing page for more.
What are groups in PostHog?
Groups are a powerful feature in PostHog that aggregate events based on entities, such as organizations or companies. They enable you to analyze trends, insights, and dashboards at an entity-level, as opposed to a user-level.
To clarify what we mean, let's look at a few examples:
For B2B SaaS apps, you can create a company group type. This enables you to aggregate events at a company-level, and calculate metrics such as
number of daily active companies
,company churn rate
, orhow many companies have adopted a new feature
.```For collaborative, project-based apps like Notion, Jira, or Figma, you can create a project group type. This enables you to calculate metrics like
project pageviews
,users per project
, andproject engagement
.For a communication app like Slack, you can create a channel group type. This enables you to measure metrics like
average number of messages per channel
,number of monthly active channels
, ortotal number of channel participants
.For a social media app like Twitter, you can create a post group type. This enables you to measure
average number of replies per post
, ortotal count of unique posters per month
.
The difference between groups and cohorts
Groups are often confused with cohorts, but they each serve different purposes:
- Groups aggregate events, and do not necessarily have to be connected to a user.
- Cohorts represent a specific set of users – e.g., a list of users that all belong to the same company.
Groups require additional code in your app to set up, while cohorts are created in PostHog and don't require additional code. This makes cohorts easier to use and quicker to get started. If your only goal is to create a list of users with something in common, we recommend cohorts instead of groups.```
How to create groups
Groups are created and defined in your code when sending events.
In the example below, we create a group type company
. Then, for each company, we set the group key
as the unique identifier for that specific company. This can be anything that helps you identify it, such as ID or domain.
We advise against using the name of the company (or any other group) as the key, because that's rarely guaranteed to be unique, and thus can affect the quality of analytics data.
// All events for that session will be associated with company `company_id_on_your_db`posthog.group('company', 'company_id_in_your_db');posthog.capture('user_signed_up')
Tip: When specifying the group type, use the singular version for clarity (
company
instead ofcompanies
).
We now have one company
-type group with a key company_id_in_your_db
. When we send the event user_signed_up
, it will be attached to this newly created group.
A single event can only belong to a single group per group type. To elaborate what we mean, we'll continue using the example above:
- It is NOT possible to assign the a single
user_signed_up
event to two companies at the same time. - It is possible to assign this event to a different group type, for example
channel
orpost
, in addition to thecompany
group type.
// ❌ Not possibleposthog.group('company', 'company_id_in_your_db');posthog.group('company', 'another_company_id_in_your_db');posthog.capture('user_signed_up')// ✅ Allowedposthog.group('company', 'company_id_in_your_db');posthog.group('channel', 'channel_id_in_your_db');posthog.capture('user_signed_up')
Group type limit: There's a hard limit of 5 group types within PostHog, although within each group type you can have an unlimited number of groups.
Setting and updating group properties
In the same way that every user can have properties associated with them, every group can have properties associated with it.
Continuing with the previous example of using company
as our group type, we'll add company_name
, date_joined
, and subscription
as additional properties.
Note: You must include at least one group property for a group to be visible in the "Persons & Groups" tab.
posthog.group('company', 'company_id_in_your_db', {name: 'PostHog',subscription: "subscription",date_joined: '2020-01-23T00:00:00.000Z'});
Properties on groups behave in the same way as properties on persons. They can also be used within experiments and feature flags to rollout features to specific groups.
Note: The PostHog UI identifies a group using the
name
property. If thename
property is not found, it falls back to the group key.
For more on implementing group analytics, check out our guide on frontend vs backend group analytics implementations.
Using groups in PostHog
Once you have set up your groups, you can use groups in PostHog to:
- Create and analyze insights for your groups.
- Set feature flags for your groups.
- Run experiments with your groups.
For detailed information on how to use groups in PostHog, as well as their limitations, check out our full groups docs.