# How to import contacts

# How do I import contacts?

This article guides you through **bulk-importing your customer directory** into Flownally using a CSV file. Learn how to use the import wizard, map fields, and resolve formatting errors to quickly launch outreach campaigns.

### In this article, you will learn how to

- **Initiate the bulk import wizard**.
- Map your CSV columns to Flownally’s default and custom fields.
- Recognize and resolve common data mapping and formatting issues.

## Before you start

Before importing contacts, make sure you have:
- A cleanly formatted **CSV (.csv) file** containing your contact information
- **Matching custom fields pre-configured in your Flownally workspace settings** if you are importing unique data points.

## How to import contacts

1. Log in to your Flownally workspace.
2. Go to the **Contacts** tab.

![](/help-center/02-contacts/01-01-contacts-start.png)

3. Click on the **arrow** next to the + Add contact button.
4. Click on the **Import from CSV**.

![](/help-center/02-contacts/02-01-add-contact-menu.png)

4. Click on the **Choose file** field.

![](/help-center/02-contacts/02-02-choosing-file.png)

6. Choose a **CSV file** to import.
7. Click **Next**.
8. **Assign fields** from Flownally by dragging and dropping them **to the columns** from your CSV file.
9. Click **Next**.

![](/help-center/02-contacts/02-03-assigning-fields.png)

9. Review the mapping.
10. Click on **Start import** to import all contacts from your CVS file.

![](/help-center/02-contacts/02-04-reviewing-mapping.png)

11. Click on the **View Contacts** button to close the side bar.

![](/help-center/02-contacts/02-05-import-completed.png)

12. Imported contacts should be visible in your contact list.

![](/help-center/02-contacts/02-06-imported-contacts.png)

## What happens after importing contacts?

After contacts are imported, your customer list will instantly populate your Flownally **contacts** with all mapped default and custom fields. Your team can immediately search for these profiles, organize them into segments, and launch bulk outreach campaigns without any manual data entry.

## Troubleshooting

### Upload rejected

This happens because the file is saved in an unsupported format instead of a true CSV file. You must save your file explicitly as a CSV in your spreadsheet software before trying the upload again.

### Missing or unmappable columns

This happens because the corresponding custom fields have not been created in your workspace settings yet. You must pause the import and [create the missing custom fields](/settings/custom-data/create-field)before restarting the wizard.

### Partial import or skipped contacts

This happens because the skipped rows are missing mandatory names or contain badly formatted phone numbers. You must fix these missing details and country codes in your spreadsheet before re-uploading the remaining rows.

## Related articles

- [How to add a contact](/contacts/add-contact)
- [How to change customer data](/contacts/customer-data)
- [How to archive a contact](/contacts/archive-contact)
- [How to create a new custom field](/settings/custom-data/create-field)