---
title: Contacts Import
description: "The **Contacts Import** tool allows you to bulk upload Contacts from external sources directly into Mria CRM. You can access it either from the [Contacts section](/docs/contacts/) or under **Settings → Data Administration → Contacts** — the process is identical in…"
url: "https://mriacrm.com/docs/contacts-import/"
updated: "2026-11-18"
category: Using Mria CRM
---

# Contacts Import

The **Contacts Import** tool allows you to bulk upload Contacts from external sources directly into Mria CRM.

You can access it either from the [Contacts section](/docs/contacts/) or under **Settings → Data Administration → Contacts** — the process is identical in both places.

## Getting Started

Before importing, you can:

- **Download a sample file** (`.CSV` or `.XLSX`) to understand the correct structure. The sample file now includes columns for any [custom fields](/docs/custom-fields/) configured on Contacts, so you can see exactly where to enter their values.
- **Export Contacts from another CRM** — Mria CRM supports files exported "as is" from most common systems.

Because Contacts involve complex linking logic (Companies, Leads, updates), the maximum file size is **1 MB**, and we recommend limiting each import to **~1,000 Contacts** per file for best performance.

## Step 1. Upload File

Drag and drop your file or click **upload** to browse your computer.

**Supported formats:** `.XLSX`, `.CSV`
**Maximum file size:** **1 MB**

Once uploaded, click **Next** to move to the field-mapping step.

[![Contacts Import: Step 1. Upload File](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-01.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-01.png)

## Step 2. Map Fields

Mria CRM tries to auto-match your file columns to system fields based on similar names.

For example, columns like *Name*, *Contact Name*, *Full Name*, or *First Name* may all map to **Name** automatically.

You can:

- Change the mapping by clicking **✕** next to a field and selecting another option.
- Leave an **optional** field unmapped — that column simply will not be imported. The required fields below are the exception: they have to be mapped for the import to run.

**Required fields:**

- **Name**
- **Email** (must be unique per Contact)

Optional fields include Company, Phone, Title and **Type**.

**Required fields cannot be skipped.** If your file has no column for one of them, add it before uploading rather than trying to map around it.

**Custom fields:** Any [Custom Fields](/docs/custom-fields/) configured on Contacts also appear in this list alongside the standard fields. They follow the same auto-match rules — a column named *Department* will map to a Department custom field automatically. You can map, change, or skip them just like any other field.

[![Contacts Import: Step 2. Map Fields](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-02.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-02.png)

💡 **Important Difference from Leads Import:**
Contacts **cannot** have duplicated emails in Mria CRM. If your file contains multiple rows with the same email, only **one** will be processed (the last one in the file), if "Update existing Contacts" is enabled.

### Combining two columns into one field

A file that keeps **First Name** and **Last Name** in separate columns no longer needs fixing up before you import it. Map **both** onto **Name** and the wizard joins them.

Mria CRM usually does this for you: if your file has columns that look like a first and a last name, both are already mapped onto Name when the step opens. Each mapped column appears as a chip with an ✕ to remove it.

[![Contacts Import: Combining two columns into one field](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-03.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-03.png)

**Join with** controls what goes between them, and the preview beside it shows the result using the first row of your file, so you can check it before importing anything:

| Join with | “Priya” + “Raman” becomes |  |
| --- | --- | --- |
| **Space** | `Priya Raman` | The default, and what you want for a name. |
| **Comma** | `Priya, Raman` | A comma AND a space — useful for “Surname, Forename” ordering. |
| **Hyphen** | `Priya-Raman` | Joined with a hyphen and no spaces. |
| **None** | `PriyaRaman` | Run together with nothing between them. |

[![Contacts Import: Combining two columns into one field](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-04.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-04.png)

**Comma** inserts a comma **and a space** — `Priya, Raman`, not `Priya,Raman`. Worth knowing before you import a few thousand rows.

This is not limited to names, and not limited to Contacts. Any two columns can be combined onto any one field, on every import wizard — the control is part of the shared Map Fields step.

## Step 3. Map Values

For fields whose values come from a fixed list, Mria CRM matches the values in your file to the options configured in the CRM: the built-in **Type** field, and any custom Dropdown, Multi-select or Labels field on Contacts.

The Fields with values sidebar on the left lists every field that has values to map. For each one, you'll see:

- The field name, labeled System or Custom.
- The field type (dropdown, select, multi-select, labels).
- A counter showing how many file values are mapped vs. the total found (for example, `3 / 4` means three of the four values in your file are mapped; one is unmapped and will be skipped).

Click any field in the sidebar to review and adjust its mapping on the right. For each value found in your file, choose the matching CRM option from **Maps to** — or leave it empty to skip that value.

**Type** is listed as `System · dropdown`. Each value in your file is matched to one of your [Contact types](/docs/company-and-contact-types/) — and unmatched rows inherit their company's type:

[![Contacts Import: Step 3. Map Values](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-05.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-05.png)

If your file has no Type column and there are no custom picklist fields on Contacts, this step may show as empty and you can proceed directly to Review Details.

[![Contacts Import: Step 3. Map Values](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-06.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-06.png)

## Step 4. Review Details

Before importing, review the summary and choose how the system should handle:

- Existing Contacts
- Companies
- Links to Leads

The **Contact Import Options** card contains four checkboxes, all unique to Contacts Import:

[![Contacts Import: Step 4. Review Details](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-07.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-07.png)

### 1. Update existing Contacts

If a Contact with the same email already exists in CRM, Mria CRM will update it with the data from your file.

- Contacts **cannot be duplicated** in Mria CRM.
- If several rows in your file use the same email, **only the last one is used** when updating.

Updating a Contact **does not** change its linked Company — only the Contact's info fields (Name, phone, job title, tags, custom fields, etc.) are updated.

### 2. Create new Companies from Contacts info

If the import finds a Company name that doesn't yet exist, Mria CRM will create it automatically and link the Contact to it.

### 3. Link to existing Companies

If a Company with the same name already exists:

- If exactly **one** match is found → it will be linked.
- If **multiple** Companies have the same name → the link will be skipped.

### 4. Link to existing Leads

Contacts and Leads are matched by **email**.

If Leads with the same email already exist in CRM, they will be linked automatically to the imported Contact.

**Summary of Contact Matching Rules:**

- Contacts are matched **by email** only.
- A Contact's email **must be unique** in CRM.
- Companies are matched **by name**.
- No Company will be unlinked during the update — only new links may be created (depending on checkboxes).

## Step 5. Import in Progress

When the import starts, you'll see a progress indicator with a running count of records processed (for example, `0 / 8 records processed`).
You can stay on this screen or click **Continue in Background** and keep working — the import will proceed automatically and you'll be notified when it finishes.

[![Contacts Import: Step 5. Import in Progress](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-08.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-08.png)

## Step 6. Import Completed

After a successful import, you'll see:

- Imported by
- Import date & time
- Total rows processed
- Records affected
- Records added
- Companies created
- Companies linked

Click **Go to new Records** to view your newly imported Contacts.

[![Contacts Import: Step 6. Import Completed](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-09.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-09.png)

## Viewing Imported Contacts

You can find imported Contacts in several ways:

- **From the**[**notification**](/docs/notifications/) you receive after the import finishes.
- **From Settings → Data Administration → Contacts**, by clicking the number in the "Records" column for the file you imported.
- **From the Contacts list**, using the **Filters** panel — the **Import files** filter lets you pick one or more import files and see exactly the Contacts that came from each.

[![Contacts Import: Viewing Imported Contacts](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-10.png)](https://mriacrm.com/wp-content/uploads/2026/11/contacts-import-10.png)

## Handling Import Errors

If your import fails (for example, due to a temporary Forge issue), don't worry — all Contacts processed before the error remain saved. Simply re-upload the same file and run the import again. The already existing Contacts won't be duplicated.

## Notifications & Assignment

If imported Contacts are assigned to another user (for example, if Contacts are linked to the user's Leads), that user will receive a notification such as:

> "Nataliia Timoshyna imported webinar_contacts_50.csv and assigned new Contacts to you."

They can open and work with these records immediately.

 [https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import](https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import)[https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import](https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import)[https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import](https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fcontacts-import%2F&linkname=Contacts%20Import)
