To import coupons into an existing coupon list.


  • The Coupon Manager is a billable feature that must be activated for your system. To activate the Coupon Manager, contact your customer service representative.

  • The coupons have been created in a shop or CRM system as a TXT or CSV file.

  • Permission 157: View and edit own coupon lists or 159: view and edit all coupon lists.

  • An FTP Server. The coupons are loaded at a given point in time to an FTP server. The FTP server can be enabled by Mapp as an optional feature, or an existing FTP can be used.

Background Information​

Additional coupons can be added to the list even if there are already coupons available in the coupon list. To ensure well organized coupon management, each coupon list should only contain one type of coupon (for example, free shipping or 25% discount).

The maximum length for each coupon code is 200 characters.

URL formats (for example, http://www.mapp.com) and personalisation placeholders cannot be used in coupon codes.

The coupons are created in a shop or CRM system as a TXT or CSV file and imported into Mapp Engage as a TXT or CSV file. The system that creates the coupon regulates the valid use of the coupon.

If the coupons need to be regularly generated and imported into Mapp Engage, the activity can be automated (see Import Coupons Into a Coupon List​).


  1. In the Main Navigation​, click Content Management​ > ​Coupon Manager​.
    ⇒ The Coupon Lists Overview​ window opens.
  2. Next to the coupon list that receives the coupons, click  > Import​ .
    ⇒ The Import Coupons​ window opens.
  3. In the Coupon Type​ area, activate a radio button to select the type of validation Engage applies to the import.
    Activate the Coupon Codes​ button if the data is imported to a list used to insert coupon codes.
    Activate the Barcodes​ button if the data is imported to a list used to generate barcode coupons.
    The window adjusts based on the selection.
  4. From the Barcode Type​ drop down list, select the type of barcode the import file contains.
    Engage supports a wide range of barcode types (see Supported Barcode Types​).
  5. In the Upload a File​ area, click the Browse​ button and select the import file on your computer.
    ⇒ The file name displays next to the Browse​ button.
  6. In the File Type​ area, activate a radio button to indicate the import file type.
    • Activate the TXT​ button if the import file is a text file.

    • Activate the CSV button if the import file is a character-separated values file.

      • In the Separator Character​ input field, enter the character used between fields in the CSV file. The default value is a comma. This field only displays when the CVS file type is selected.

  7. From the Encoding​ drop-down list, select which type of character encoding is used for the file.
    Click the  button to open a list of available encoding options. Click the  symbol to select the encoding.
    For more information about character encoding, see http://en.wikipedia.org/wiki/Character_encoding .
  8. From the Import Mode​ drop-down list, select the method of synchronisation used for the import.
    The following options are available:

      • Add: This option adds the imported coupon codes to the coupon codes that are already saved in Engage.

      • Replace: This option deletes all of the coupon codes that are already saved in Engage and imports the data from the import file as new codes.

      • Delete: This option deletes the coupon codes in Engage that correspond to codes in the import file. Existing coupon codes that are not in the imported file remain in Engage and are not changed.

    It is not possible to start a replace or delete import while a coupon list is in use for a sendout.

    If a sendout begins while a coupon list is locked by a replace or delete import, the sendout is delayed until the import is finished.

    Coupons can be added to a list at any time.

  9. Click the ​Import​ button.
    ⇒ The Coupon Lists Overview​ window opens. As soon as the coupons are loaded, the number of coupons in the Available Coupons​ column updates.
    A system message (SysMsgCouponImport) with information about the import is sent to the user who imported the coupons.
    The uploaded coupons are available for use in messages (see ​Add Coupons to a Message​).