> For the complete documentation index, see [llms.txt](https://docs.cookie3.com/cookie3-analytics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cookie3.com/cookie3-analytics/features/kol-intelligence/your-kols/importing-kol-lists.md).

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