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

# Bulk import contacts

> Import many contacts at once from a spreadsheet.

Bulk import lets you load hundreds or thousands of contacts in a single run from a spreadsheet (CSV or XLSX).

## Before you start

* A CSV or XLSX file with one row per contact
* Column headers for the fields you want to import (at minimum: name and phone with country code)
* Duplicates removed beforehand if possible

## Steps

<Steps>
  <Step title="Open Contacts">
    Navigate to the contacts module.
  </Step>

  <Step title="Click Import">
    Open the import flow.
  </Step>

  <Step title="Upload your file">
    Drag and drop your CSV or XLSX file.
  </Step>

  <Step title="Map columns">
    Match each column in your file to a Clapvo field.
  </Step>

  <Step title="Review the preview">
    Check the first few rows look right before continuing.
  </Step>

  <Step title="Run the import">
    Clapvo processes the file and reports how many succeeded.
  </Step>
</Steps>

## Tips

* Always include a valid country code on phone numbers (for example, +1, +91, +55). Rows with an invalid country code or mobile number are rejected before import, so they can't slip into your contacts.
* Imports run in the background. Check [Import history](/docs/product/contacts/import-history) for results and any rows that failed.
* Tag the rows during import so you can find this batch later.

## Related

* [Import history](/docs/product/contacts/import-history)
* [Add a contact](/docs/product/contacts/add-contact)