> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/en/cohort/create.md).

# Create Cohort

## Creating a Cohort

You can create a Cohort for each type using the methods below.

**Dynamic Cohort**

1. Create directly by setting conditions in the Cohort menu
2. Save a Cohort satisfying specific conditions from a data analytics chart

**Static Cohort**

1. Create by uploading a CSV file directly in the Cohort menu

## Dynamic Cohort

A Dynamic Cohort uses event/property conditions to automatically update the list. You can create one with your desired conditions as follows.

### Creating Directly from the Cohort Menu

Click **`Create Cohort`** in the top right of the **`Cohort menu`** in the left navigation, then click the **`+ Create Manually`** button.

<figure><img src="https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-ac08468cdbf45c81a97c7493f8108a7dd3b10f1f%2Fimage%20(24).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 1. Enter Cohort Name and Description

Enter the name and description of the Cohort. Write content that describes the characteristics of the Cohort.

#### 2. User Identifier Basis

This defines which user identifier is used to identify users who satisfy the Cohort conditions. You can change the User Identifier Basis even after the Cohort is created.

#### 3. Set Conditions

#### **Event**

* You can set conditions for whether a desired action was performed or not performed within a specific period.
* You can also set a condition for how many times a specific action was performed. Additionally, you can use comparison operators to create a Cohort satisfying conditions within a specific count range.

Example) A Cohort of users who triggered the click\_product event 3 or more times in August 2023, and triggered the add\_to\_cart event exactly once within the last 7 days

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-2e405e6f7c34103ac471cd5594f90d81ec4e4b3a%2Ff2e625b-_2023-08-31__3.52.35_61780d2356a711b4.png?alt=media)

* By using periodicity and property value conditions, you can run personalized CRM campaigns based on RFM segments.

Example) A Cohort of users who triggered the purchase completion event at least once per week during the last month

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-4471aacca2f12a616aa3c53777f6b9193d70a891%2Fd7280f44dae0082fd9fd2db1ab3e6becf6010367_0e25100a43ac72ce.png?alt=media)

Example) A Cohort of users who triggered the purchase completion event in 1 or more categories during the last month

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-392e9253a1993c343312c3545e8b0eb09698c956%2F0538412f23602dc981ddc004a99bf987f36c8b02_e028783cfc27eb32.png?alt=media)

#### **Property Within a Period**

* You can create a Cohort of users who meet the set property conditions within a specific period.

Example) A Cohort of users whose signup\_date property was July 30, 2023 or earlier within the last 7 days, or users whose gender property was FEMALE within the last 7 days — satisfying at least one condition

You can configure the desired user list using the 'Ever' and 'Most Recent' conditions as follows.

* 'Ever': Users whose marketing consent property was Y at any point during the last 7 days (including users who changed from Y to N)
* 'Most Recent': Users whose most recent state of the marketing consent property during the last 7 days was Y (excluding users who changed from Y to N)

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-e13ec8d5da0d9ac7ca5c4c555f62226e436ebf4e%2F6ceb9ca-_2023-08-31__3.57.38_4a163484090afe60.png?alt=media)

#### **Funnel**

* You can set conditions for whether a desired action was performed step by step within a specific period, or was not performed.
* You can create a Cohort from the funnel that leads up to a specific user action, and you can choose the funnel type to calculate conversions and drop-offs at each step.
* Currently two funnel types are supported: \[Closed Funnel] and \[Sequential Order Funnel].

Example) A Cohort of users who triggered the product\_viewed -> add\_to\_cart -> purchase\_click -> purchase\_payment events in a Closed Funnel format within the last 7 days

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-d47c80e2a0b2d990f5911d4f454c0a640943af6d%2Fee50ac1-_2023-10-24__11.29.07_661f510f56bb719d.png?alt=media)

#### Current Property

* Define a Cohort by the user's current Property Value.
* Regardless of past history, you can identify only the users who meet this condition right now.

Example) Users whose current membership tier is VIP.

<figure><img src="https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-43910a1ef7c7f017960180df376b1544bf3d1423%2Fimage%20(25).png?alt=media" alt=""><figcaption></figcaption></figure>

### Creating a Cohort from a Data Analytics Chart

#### 1. Creating a Cohort from an \[Insight] Chart

The \[Insight] chart supports creating a Cohort from the group of users that make up the analysis results at a specific point in time.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-5f2be6af58f77b09fedcad0b57045f2b0f9e4cd7%2F089dd87-_2023-08-31__4.04.02_cae46d89839632f1.png?alt=media)

From the Data Analytics menu > \[Insight] chart, select a specific date to create the desired Cohort. When you hover over the desired point on the graph, a modal appears, and you can see the 'Save as Cohort' button in the modal.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-bb3f365aebc1d78309aafd170423dcf7ff8389fe%2Fc483fd1-_2023-08-31__4.07.58_0006052bc01c709d.png?alt=media)

Click that button, enter the Cohort name and description, then click the 'Save' button to complete Cohort creation.

#### 2. Creating a Cohort from a \[Funnel] Chart

The \[Funnel] chart lets you compose events by step to analyze conversion rates and drop-off rates at each step.

This chart supports extracting converted users and dropped-off users at each step as a Cohort.

* Currently, Cohort creation is only supported for the \[Closed Funnel] and \[Sequential Order Funnel] types.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-57fc7bab1a65f15f7a48f98c5e389192563088da%2Ff2182ce-image_1_2eb31a1deafcbaf5.png?alt=media)

## Static Cohort

You can also create a Cohort by **uploading a CSV file**. Cohorts created through direct file upload are classified as the `Static` type. A Static Cohort is a static — that is, fixed — list of user identifiers.

| Category      | Description     |
| ------------- | --------------- |
| File Size     | Up to 128MB     |
| File Format   | CSV             |
| Number of IDs | Up to 1,000,000 |

{% hint style="info" %}
Each row is treated as one entry. If there are duplicate entries in the file, they are counted as one entry.
{% endhint %}

{% hint style="warning" %}
Each row (identifier) value in the CSV cannot exceed 128 characters.
{% endhint %}

### Creating a Cohort by Uploading a File

#### 1. Visit the Cohort Page

Click **`Create Cohort`**, then click the **`+ Upload CSV File`** button to upload.

<figure><img src="https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-d7770e03609120524f0dad7cc7e123d044eb4b3b%2Fimage%20(27).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 2. Select a CSV File

In the modal that appears after clicking the button, you can upload a file by **selecting it directly** or **dragging and dropping** it.

<figure><img src="https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-2e57e458ffcf2a8f77af698296f13716bc33a149%2Fimage%20(28).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 3. Upload and Create

#### 3-1. Fill in the required information and click the Create button.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-f82f30848e29631af6547e01300e3086cb0df7d9%2Fb8b9d42-_2024-05-31__4.26.35_a849d0404c6b45cf.png?alt=media)

#### 3-2. Wait for the Cohort upload to complete.

The CSV upload process may take up to 5 minutes.

If you leave the page during this process, the Static Cohort upload may fail.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-4c049967b4410a0bbf3d38346aa1e40723232d96%2F9a38821-_2024-05-31__4.26.44_7f43fd0db32719b6.png?alt=media)

### Re-uploading a Static Cohort

You cannot directly modify a Static Cohort after it has been created.

Instead, you can re-upload the file for an already-created Static Cohort.

#### Cohort Detail Screen

Click the `Re-upload File` button on the detail screen of the created Cohort.

![Created Cohort detail screen](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-26f84f6e78f3340e690af830f95d24ded1b3f30e%2F943c963-_2024-05-31__4.31.05_ae591c28f8ca0f4e.png?alt=media)

If the re-upload is successful, the existing user list is removed and replaced with the newly uploaded user list.

If you need to modify a Cohort that is already in use, it is recommended to re-upload using this method rather than creating a new Cohort.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hackle.io/en/cohort/create.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
