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

# Import Contacts

> Bulk import contacts from CSV or Excel files

## Supported formats

* **CSV** (`.csv`)
* **Excel** (`.xlsx`, `.xls`)

## Import process

<Steps>
  <Step title="Go to Contacts">
    In the dashboard, click **Contacts** in the sidebar.
  </Step>

  <Step title="Click Import">
    Click the **Import** button and select your file.
  </Step>

  <Step title="Map columns">
    Map your file's columns to Orova fields:

    * **Contact Name** (required)
    * **Phone Number** (required)
    * **Region** (optional)
    * Any additional columns become custom fields
  </Step>

  <Step title="Review and import">
    Preview the mapped data and click **Import** to create the contacts.
  </Step>
</Steps>

## File format

Your CSV should look like:

```csv theme={null}
contactName,phoneNumber,region,accountNumber
John Smith,+12025551234,US East,ACC-001
Jane Doe,+442071234567,UK,ACC-002
```

<Info>
  Phone numbers should be in E.164 format (e.g., `+12025551234`). Orova will attempt to normalize other formats.
</Info>

## Custom fields

Any columns beyond `contactName`, `phoneNumber`, and `region` are stored as external fields. These are available as variables in the agent's system prompt using `{{fieldName}}` syntax.