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

# CSV Import

> How to use Drippi.ai's CSV import feature

## How to Use Drippi's CSV Import Feature (video)

[https://www.youtube.com/watch?v=YNZkV\_d3Luc](https://www.youtube.com/watch?v=YNZkV_d3Luc)

## How to Use Drippi's CSV Import Feature (SOP)

Importing a lead list into drippi by their usernames is fairly straightforward

Just make sure your CSV is formatted similarly to the one you'll find below👇

1. Head to the find leads page, then select new lead source.

   <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.19.23AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=0c66bb979ff4c40f05e06e56ea52bf71" alt="Screenshot 2025-10-27 at 9.19.23 AM.png" width="412" height="678" data-path="images/Screenshot2025-10-27at9.19.23AM.png" />

   <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.19.38AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=818306129d50134b467ae6411dc28a68" alt="Screenshot 2025-10-27 at 9.19.38 AM.png" width="998" height="650" data-path="images/Screenshot2025-10-27at9.19.38AM.png" />
2. Select CSV import:

   <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.19.59AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=5409e37014dd675f75071bad7d96f914" alt="Screenshot 2025-10-27 at 9.19.59 AM.png" width="726" height="644" data-path="images/Screenshot2025-10-27at9.19.59AM.png" />
3. Upload a file by selecting "browse files" or by dragging and dropping a CSV file:

   <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.22.27AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=571a3ebb14196d031209278e0d753d5d" alt="Screenshot 2025-10-27 at 9.22.27 AM.png" width="1770" height="758" data-path="images/Screenshot2025-10-27at9.22.27AM.png" />

   <Warning>
     In order to upload a file, it must be in the correct format. Files only NEED usernames. DO NOT INCLUDE "@" symbol or links.\
     \
     Example: penunurialex NOT @penunurialex NOT [https://twitter.com/penunurialex](https://twitter.com/penunurialex)
   </Warning>

   <Info>
     Our CSV import system supports the addition of any custom personalization fields you may have, more information on that below.
   </Info>
4. Ensure you select the column containing the list of usernames in the dropdown menu. Then name and save your lead source

   <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.22.48AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=742cfe57e968e7362bc4176f01d25d10" alt="Screenshot 2025-10-27 at 9.22.48 AM.png" width="1876" height="1068" data-path="images/Screenshot2025-10-27at9.22.48AM.png" />

<Warning>
  By username we are referring to "handle" or "@" NOT their "name"\
  \
  Example:

  <img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.24.48AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=1b49d78a435def4a3d31449fed9f3400" alt="Screenshot 2025-10-27 at 9.24.48 AM.png" width="814" height="594" data-path="images/Screenshot2025-10-27at9.24.48AM.png" />
</Warning>

## **Importing with Drippi's CSV format**

CSV's that use Drippi's CSV format will be imported much faster and do not require additional lead credits to import.

Here's an example of our required format👇

[https://docs.google.com/spreadsheets/d/1CR8eQECeIezDCas2RBoo7SFhde-fyRfQRKntFinSDss/edit?usp=sharing](https://docs.google.com/spreadsheets/d/1CR8eQECeIezDCas2RBoo7SFhde-fyRfQRKntFinSDss/edit?usp=sharing)

This is the same format that is used when you export leads from Drippi by clicking the download button on the page of that lead source.

<img src="https://mintcdn.com/drippi/G6t_xRqQ3e88J6Kv/images/Screenshot2025-10-27at9.30.41AM.png?fit=max&auto=format&n=G6t_xRqQ3e88J6Kv&q=85&s=b83ff3031652be804cdbec057ade4fe1" alt="Screenshot 2025-10-27 at 9.30.41 AM.png" width="1830" height="492" data-path="images/Screenshot2025-10-27at9.30.41AM.png" />

<Info>
  If your CSV matches Drippi's export format you will see an indicator that verifies your document is formatted correctly:

  <img src="https://mintcdn.com/drippi/-7aCeXsWHlXzLtmd/images/Screenshot2025-10-27at9.32.50AM.png?fit=max&auto=format&n=-7aCeXsWHlXzLtmd&q=85&s=0a238c621facc0a9ea222fab4f3e0024" alt="Screenshot 2025-10-27 at 9.32.50 AM.png" width="1262" height="482" data-path="images/Screenshot2025-10-27at9.32.50AM.png" />
</Info>

<Warning>
  To integrate data from external sources into Drippi's system, it's essential to ensure that every field is both accurate and formatted correctly. Uploading data that's incorrect or not properly formatted can disrupt your automation processes or prevent the data from being successfully imported.
</Warning>

## **Importing Custom Variables (Custom Personalization Info)**

Our CSV import system supports the addition of any custom personalization fields you may have.

To include this data in the lead source. verify that the column has a descriptive name and the field exists for every lead.

Example:

<img src="https://mintcdn.com/drippi/-7aCeXsWHlXzLtmd/images/Screenshot2025-10-27at9.34.14AM.png?fit=max&auto=format&n=-7aCeXsWHlXzLtmd&q=85&s=68ffc5640646d51164be427c241f958e" alt="Screenshot 2025-10-27 at 9.34.14 AM.png" width="818" height="352" data-path="images/Screenshot2025-10-27at9.34.14AM.png" />

Then after uploading your data, select the custom variables you would like to import.

<img src="https://mintcdn.com/drippi/-7aCeXsWHlXzLtmd/images/Screenshot2025-10-27at9.34.56AM.png?fit=max&auto=format&n=-7aCeXsWHlXzLtmd&q=85&s=6dd912c53cead4a7e759ebeda8d37a71" alt="Screenshot 2025-10-27 at 9.34.56 AM.png" width="1766" height="894" data-path="images/Screenshot2025-10-27at9.34.56AM.png" />

<Danger>
  **Incomplete personalization in your CSV can disrupt your campaigns.**

  Ensure every lead has the necessary custom data before using the variable.
</Danger>

<Tip>
  If you have any questions, please reach out to us @ [support@drippi.ai](mailto:support@drippi.ai) or book a call with our customer support team here: [https://cal.com/team/drippi/customer-support-chat](https://cal.com/team/drippi/customer-support-chat)
</Tip>
