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

# How to Merge Customer Profiles via File Import

To merge customer profiles in your account, prepare a file in the right format and run an import. Merging builds a [unified customer profile](https://help.maestra.io/customers-orders-and-products/customers/merging-customers/how-maestra-creates-a-unified-customer-profile.md) and brings together everything you know about that customer.

Need to merge with a different data source? Use the [advanced settings](#step-4-configure-the-import).

Imports run under **Customer Data Platform → Imports**. Click **New import** to open the settings.

## Step 1. Choose the import type

* Pick the import type — **Customers**.
* Pick the action — **Merge customers**.

## Step 2. Prepare and upload the file

Work out which profiles you want to merge. The file has to contain every required field:

| Field | Required | Description |
| - | - | - |
| ID of the customer to merge into (`ResultingCustomerIdsMindboxId`) | ✅ | Maestra ID of the primary customer, whose profile the data is merged into |
| ID of the customer to merge (`CustomersToMergeCustomerIdsMindboxId`) | ✅ | Maestra ID of the customer whose data is moved over |

Build the file. Use the first row for the names of the fields you're loading — the wording is up to you.

* Format: `.csv` or `.txt`.

See [Preparing a file for import](https://help.maestra.io/import-data/preparing-a-file-for-import.md) for the full set of recommendations.

Upload the file and click **Continue**.

## Step 3. Map the file's fields

Maestra Platform maps the file's columns to its own fields automatically. Check the result and adjust it by hand if you need to:

* In the **Import** column, tick the fields you want to load. Unticked columns are skipped.
* In the **Maestra field** column, map each file column to a field on the account. Optional fields left unmapped are skipped.

Click **Continue**.

## Step 4. Configure the import

This step sets extra parameters for the import:

* **Data source** (integration point) — where the data came from. Affects how the customer's actions are attributed. Defaults to the Maestra admin panel.
* **Comment** — a description of the import. Makes it easier to find in the list later.

If the integration point you need doesn't exist yet, create it in advance or from the link on the import page. Then pick it in the settings.

## Step 5. Review and start the import

Before you start, Maestra Platform shows the first rows of the file with the mapping already applied. Check that the data looks the way you expect — that the right values landed in the right fields.

If everything's correct, click **Start import**.

## How to track the import

Once started, the import appears in the list on the **Import** page. For each task you'll see:

* start date,
* import type,
* source file with its comment,
* load progress,
* rows imported and errors,
* who started it.

If errors came up during the import, some rows were skipped. Open the import details to see which rows had a problem and why. Fix them in the file and run the import again.


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