> ## 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 Import Customers with Discount Cards

Use this import to load customers together with their [discount cards](https://help.maestra.io/loyalty/discount-cards/how-to-bulk-import-discount-cards.md) from one file.

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 and their cards**.
* Pick the action — **Add and edit cards and customers**.

## Step 2. Prepare and upload the file

Work out which fields you need. The file has to contain every required field.

To identify customers, use their email address, mobile phone, or another identifier.

| Field | Required | Description |
| - | - | - |
| Card status (`Status`) | ✅ | One of: `Inactive` — not activated `Activated` — activated `Blocked` — blocked |
| Status change time (`StatusChangeDateTimeUtc`) | ✅ | Date and time the discount card's status changed, in UTC |
| Discount card number (`CardNumber`) | ❌ | Needed when you import new cards |

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`.
* Check that the values match the allowed formats.

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.

> [!TIP]
>
> If a custom field you need doesn't exist yet, create it with the **Create custom field** button.

Click **Continue**.

## Step 4. Configure the import

This step sets extra parameters for the import action:

* **Data source** — the integration point the data came through. Affects how the customer's actions are attributed. Defaults to the Maestra admin panel.
* **Touchpoint** — the channel or integration the action is tied to. By default it's detected automatically from the integration point. To tie customers to a specific website or store, pick the touchpoint manually.
* **Create cards** — when it's on, new cards are created from the `CardNumber` column.
* **Comment** — a description of the import. Makes it easier to find in the list later.

## 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.

## The result

Once the task finishes, the customers and their cards are loaded.


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