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

# Creating User Group Cohorts

> How to create cohorts that target groups of users (households) rather than individuals

## Overview

User Group Cohorts (also called Household Cohorts) allow you to target groups of users rather than individuals. Behavior is aggregated across the entire group, enabling household-level targeting.

<Info>
  **Prerequisites:**

  * User Group Cohorts enabled for your organization (contact your Customer Success Manager)
  * User group membership data imported via Connectivity
  * Access to the Permutive Dashboard with cohort creation permissions
</Info>

## Steps

<Steps>
  <Step title="Verify prerequisites">
    Ensure User Group Cohorts have been enabled for your organization and that user group membership data has been imported via Connectivity.
  </Step>

  <Step title="Create new cohort">
    Navigate to *Custom Cohorts* and click *+ Add Cohort*.
  </Step>

  <Step title="Set precision type">
    Toggle the *Cohort Precision Type* field to *User Group Cohort*.
  </Step>

  <Step title="Define criteria">
    Define your cohort criteria. Note the aggregation behavior:

    * **First-party/engagement/session clauses**: Behavior is aggregated across the entire group
    * **Audience Imports/third-party clauses**: Satisfied if *any user within the group* meets the criteria
  </Step>

  <Step title="Save">
    Calculate the audience size and save the cohort.
  </Step>
</Steps>

## Identifying User Group Cohorts

User Group Cohorts appear in your cohort list with a *User Group* indicator in the *Precision Type* column.

## Example

| Cohort Type       | Criteria                                           | Who Qualifies                                               |
| :---------------- | :------------------------------------------------- | :---------------------------------------------------------- |
| Regular Cohort    | "Users who viewed 3+ sports articles"              | Individual users who viewed 3+ articles                     |
| User Group Cohort | "Households where users viewed 3+ sports articles" | All users in households where the combined view count is 3+ |

## Platform Support

<Note>
  User Group Cohorts have limited platform support for activation.
</Note>

| Platform   | Support                                  |
| :--------- | :--------------------------------------- |
| Web        | Full support                             |
| iOS        | Event collection only (no activation)    |
| Android    | Event collection only (no activation)    |
| CTV        | Event collection only (no activation)    |
| API Direct | Full support (client manages activation) |

User Group cohorts are activated against User IDs, not Group IDs.

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Connectivity" icon="plug" href="/products/connectivity/imports">
    Set up user group data imports
  </Card>

  <Card title="Create Basic Cohorts" icon="users" href="/guides/signals/cohorts/custom/creating-custom-cohorts">
    Learn cohort creation fundamentals
  </Card>

  <Card title="Back to Custom Cohorts" icon="arrow-left" href="/products/signals/cohorts/custom">
    Return to product overview
  </Card>
</CardGroup>