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

# How to import contacts

> Bring your client contacts in from a spreadsheet.

Import your client contacts from a CSV or Excel file. Each person needs a name, and a company or a work email.

<Steps>
  <Step title="Open the import">
    On **Contacts**, select **Import** › **Import CSV** (in **⋯** from 20 contacts), or drop the file on the page.

    <Frame>
      <img src="https://mintcdn.com/skillflo/CelhFopCZiSxA9Go/images/guides/import-file-v1.png?fit=max&auto=format&n=CelhFopCZiSxA9Go&q=85&s=5aa5e9b4e331f20ee05f8a772d61d047" alt="The first step of Import contacts: one drop zone, the file limits in one line, and the Paste from a spreadsheet instead and Download template links" width="608" data-path="images/guides/import-file-v1.png" />
    </Frame>
  </Step>

  <Step title="Add your file">
    Drop the file or select **Browse files**, then choose the row that holds the column names. **Download template** gives Hire's columns.

    <Frame>
      <img src="https://mintcdn.com/skillflo/CelhFopCZiSxA9Go/images/guides/import-header-v1.png?fit=max&auto=format&n=CelhFopCZiSxA9Go&q=85&s=8848bc0674f5890baf9337bd41246de0" alt="Which row holds the column names, with Row 1 chosen above two pasted rows" width="608" data-path="images/guides/import-header-v1.png" />
    </Frame>
  </Step>

  <Step title="Map the columns">
    Check each column's Hire field. Sensitive columns show **Left out: sensitive data** and never import.

    <Frame>
      <img src="https://mintcdn.com/skillflo/CelhFopCZiSxA9Go/images/guides/import-contacts-map-v3.png?fit=max&auto=format&n=CelhFopCZiSxA9Go&q=85&s=74be5590c07c6c6a3eb2667cde966ca8" alt="The column mapping for a contacts file, with CCCD and Date of birth marked Left out: sensitive data" width="608" data-path="images/guides/import-contacts-map-v3.png" />
    </Frame>
  </Step>

  <Step title="Preview and import">
    Select **Preview**. Each row says **New**, **Fill**, **Skip** or **Problem**. Then select **Import N contacts**.

    <Frame>
      <img src="https://mintcdn.com/skillflo/CelhFopCZiSxA9Go/images/guides/import-preview-v1.png?fit=max&auto=format&n=CelhFopCZiSxA9Go&q=85&s=2d384a0a96644b1780d4305713ba6ca7" alt="The import preview: 2 new, each row with its result, and Import 2 contacts" width="608" data-path="images/guides/import-preview-v1.png" />
    </Frame>
  </Step>
</Steps>

## How Hire matches

| Record | Matched by | When nothing matches |
| - | - | - |
| Person | Email, phone or LinkedIn. Never by name alone | A new Contact |
| Company | Website, then name, without its legal form | A new Company. A work email's domain becomes its website |

One file holds up to 1,000 rows and 1 MB. For several files, [import with Flo](/guides/how-to/import-with-flo).

## If something looks wrong

* **"Add the company".** Give the row a Company column or a work email. Gmail and Outlook addresses never name a company.
* **A row is refused.** Its email is a colleague's or on your agency's email domains.
* **A row has no name.** Select **Use names from mail** to fill it from your mail.
* **Wrong import.** Select **Undo import** within 14 days.
* **"Not added, possible match" or "looks like".** The person may be someone you have: the same name, a nickname, or the same address with a +tag. Add them by hand if they're someone else.
* **"is a shared inbox, not a person".** An address like careers@, hr@, info@ or noreply@ is a team's inbox. Import the people who read it instead.


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