> 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/static-cohort.md).

# CSV File Upload (Static)

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 %}

{% hint style="info" %}
**Check the example below for a file suitable for Static Cohort upload.**

List the identifiers you want to upload without column separators.

* [Download example CSV 💾](https://docs.google.com/spreadsheets/d/e/2PACX-1vRb0yfguRhi9g-KjwLDYakLmN-XojncKdlpwKMP0tcNhKdyszyIBxnE4dKNAJhAxfB02Bqrap-TGXWC/pubhtml)
  {% endhint %}

## Creating a Cohort by Uploading a File

### 1. Visit the Cohort Page

Go to the Cohort page and click the `File Upload` button.

![](/files/9x5eq7s14iBxtwKULOFz)

### 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.

![](/files/uhJZ6ZYYBthermtPJ3my)

### 3. Upload and Create

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

![](/files/beEHvlUUecT6UDS9WWCK)

#### 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.

![](/files/rfNFvFa17Ce4kpS4UjuD)

## 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](/files/GaocDkKk2RhCqZSL1P4W)

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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.