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

# How do I import contacts from a CSV?

> Import your contacts into Klipy from a CSV. Here's which fields are supported, how duplicates are handled, and how to fix common import errors.

You can import an existing contact list into Klipy from a CSV file. This is useful when migrating from another CRM, importing leads from a spreadsheet, or adding contacts in bulk.

## Before you import

Your CSV file needs at minimum one of these fields to be useful:

* **Email address** (strongly recommended — used for deduplication)
* **Full name** or **First name + Last name**

### Supported fields

Klipy maps common CSV column names automatically. For best results, use headers that match these:

| CSV column | Klipy field |
| - | - |
| `email` / `Email` | Email address |
| `first_name` / `First Name` | First name |
| `last_name` / `Last Name` | Last name |
| `company` / `Company` | Company name |
| `title` / `Job Title` | Job title |
| `phone` / `Phone` | Phone number |
| `linkedin_url` | LinkedIn profile URL |
| `website` / `company_website` | Company website |
| `notes` | Notes |

If your column names differ, you'll have the option to map them manually during the import flow.

## How to import

**1. Go to Contacts**

Navigate to **Contacts** in the left sidebar.

**2. Click Import**

Look for the **Import** button in the top-right area of the Contacts view.

**3. Upload your CSV**

Select your CSV file. Klipy will preview the first few rows and attempt to map your columns to its fields automatically.

**4. Review and confirm column mapping**

Verify the column mapping looks correct. If Klipy misidentified a column, use the dropdown to reassign it. Unmapped columns are skipped.

**5. Start the import**

Click **Import**. Klipy will process the file and add contacts to your database.

## How duplicates are handled

If a contact with the same email address already exists in Klipy, the import **skips** that row — it does not overwrite or update the existing record.

> [!WARNING]
>
> If you want to update existing contacts with new field values (e.g. a new phone number or title), you'll need to edit those records manually in Klipy. Bulk updates via CSV are not currently supported.

## Common import problems and fixes

> [accordion] My CSV has columns but they're not mapping correctly
>
> Check that your CSV uses comma-separated values (not tab or semicolon). Also ensure the first row is the header row with column names. If your file uses a different delimiter, open it in a spreadsheet app and export it as standard CSV.

> [accordion] Some contacts didn't import — no error shown
>
> Rows without an email address may be silently skipped if Klipy can't create a unique identifier for the contact. Adding an email column improves the import success rate significantly.

> [accordion] I imported duplicates by accident
>
> If your import created duplicates (e.g. because contacts already existed without an email to match against), contact support with details about the import. We can help clean up bulk duplicates.

> [accordion] How large can the CSV file be?
>
> There's no hard row limit documented, but very large imports (10,000+ rows) may take a few minutes to complete. Import performance degrades for very large files — split them into batches if you encounter issues.

> [card] [How to export contacts](https://klipy.ai/docs/faq/export-contacts.md)
>
> Export your Klipy contacts to a CSV file.

> [card] [Migrating from another CRM](https://klipy.ai/docs/faq/crm-migration.md)
>
> Tips for moving your data from HubSpot, Salesforce, or another CRM.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.