# Importing KOL Lists

## Step 1: Click on “Add KOLs” from the Project Dashboard

* Locate the “Add KOLs” Button

<figure><img src="/files/PTsHjOl4SxUaM9nqPAUJ" alt=""><figcaption></figcaption></figure>

## Step 2: Click the “Import CSV” Button

1. Find the “Import CSV” Option:
2. In the top-right corner of the “Add KOLs” page, click on the “Import CSV” button. This will open the CSV import interface.

## Step 3: Upload Your CSV File

Choose How to Upload:

* Drag and Drop:
  1. Locate your CSV file on your computer.
  2. Drag the file and drop it onto the highlighted area labeled “Drag and drop your CSV file here.”
* Use File Browser:
  * Click the “Import CSV” button again (if the drag-and-drop area isn’t suitable).
  * This will open your system’s file browser.
  * Navigate to the folder containing your CSV file.
  * Select the file and click “Open”.

## Step 4: Select the Relevant Column

Preview Your CSV Data:

* After uploading, a preview of your CSV file’s data will appear on the screen.
* Identify the Correct Column:
  * Look for the column that contains the Twitter handles or X profile URLs of the KOLs.
* Select the Column:
* Click on the header of the relevant column to select it.
* Ensure that only the column with the Twitter handles or profile URLs is selected for accurate processing.

## Step 5: Extract KOL Handles Automatically

Automatic Extraction:

* Our algorithm will automatically process the selected column.
  * It will extract the relevant KOL handles from Twitter handles (e.g., @exampleuser) or X profile URLs.
* Review Extracted Handles:
* Verify that the extracted handles are correct.
* If there are any errors, you may need to adjust your CSV file or re-select the appropriate column.

## Step 6: Name Your List and Save

1. Provide a List Name:
   1. Enter a unique and descriptive name for your KOL list in the “List Name” field. This helps you organize and manage multiple lists within the platform.
2. Save the List:
   1. Click the “Save” button to finalize the import process.
3. Confirmation:
   1. You should see a confirmation message indicating that your list has been successfully uploaded.
4. Processing:
   1. The platform will begin processing the KOLs in your list. This may take some time, during which the loading status will be displayed.

## Additional Tips

#### CSV File Format:

* Ensure your CSV file is properly formatted with headers for each column.
* Only one column should contain the Twitter handles or profile URLs.

#### Data Accuracy:

* Double-check that all Twitter handles are correct and active to avoid processing errors.

#### Handle Formats:

* Twitter handles shouldn't include the “@” symbol (e.g., @exampleuser).
* Profile URLs should be complete (e.g., <https://twitter.com/exampleuser>).

#### Avoid Duplicates:

* Remove any duplicate entries in your CSV file to streamline the processing time.

## What Happens Next?

#### Data Collection and Analysis:

1. The platform will collect data from each KOL’s Twitter activity over the past three months.
2. It will analyze tweets, engagements, and other relevant metrics.

#### Loading Status:

During this time, a loading status will appear next to each KOL in your list.

* Processing typically takes about one hour but may vary based on system load and data volume.


---

# Agent Instructions: 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:

```
GET https://docs.cookie3.com/cookie3-analytics/features/kol-intelligence/your-kols/importing-kol-lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.