---
title: "Import Coupons"
slug: "import-coupons-window"
updated: 2026-08-28T12:01:57Z
published: 2026-08-28T12:01:57Z
canonical: "docs.mapp.com/import-coupons-window"
---

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

# Import Coupons

## Overview

Import coupon codes to an existing list by uploading a TXT or CSV file. You can add, replace, or remove codes depending on your needs.

> [!NOTE]
> 💡 Coupon codes must not exceed 200 characters. URLs and personalization placeholders are not allowed.

---

## Navigation Path

1. *Content > Voucher Manager > Coupons*
2. Select a coupon list, then click **︙ > Import** in the *Actions* column

---

## Settings

| Setting | Description |
| --- | --- |
| **Coupon Type** | Defines the validation method for imported data: `Coupon Codes` or `Barcodes`. |
| **Barcode Type** | Specifies the barcode format (e.g., EAN, QR). Only visible when `Barcodes` is selected. |
| **Upload a File** | Select a TXT or CSV file for import. |
| **File Type** | Choose between `TXT` and `CSV`. Empty lines or whitespace are ignored. |
| **Separator Character** | Defines the delimiter used in CSV files (default: comma). Only shown for CSV imports. |
| **Encoding** | Character encoding of the file. Must match the file's actual encoding. Common options include `UTF-8` (recommended for multilingual data) and `ISO 8859-15` (for Western European languages). |
| **Import Mode** | Determines how imported data is handled: • `Add`: Adds new codes • `Replace`: Deletes existing codes and imports new ones • `Delete`: Removes only the listed codes, others remain unchanged |

---

## Actions

| Action | Description |
| --- | --- |
| **Import** | Starts the import. A system message (`SysMsgCouponImport`) is sent to the *System Messages* section (Messages > System Messages > System-Wide) with the result of the import, including the number of codes added, skipped, or rejected. |
| **Cancel** | Closes the window without importing. |

---

## Additional Information

### Import Behavior

- During `Replace` or `Delete` imports, the coupon list is temporarily locked.
- If a sendout starts while the list is locked, it is delayed until the import is complete.
- `Add` mode does not lock the list and can be used at any time.

### File Structure

- The file contains one coupon code per line, in a single column. Do not include a header row.
- The **Coupon Type** setting only changes how each code is validated, not the file layout. `Coupon Codes` accepts any alphanumeric value. `Barcodes` validates each code against the character rules of the selected **Barcode Type** (for example, EAN-13 accepts numeric characters only).

Example file with three coupon codes:

```plaintext
discount_001
discount_002
discount_003
```