Import Coupons

Updated
  • 1 minute(s) read
Prev Next

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.

💡 Coupon codes must not exceed 200 characters. URLs and personalization placeholders are not allowed.

  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:

discount_001
discount_002
discount_003