To create a coupon list.


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

Background Information​

In Mapp Engage, coupons are managed in coupon lists. To ensure well-organized coupon management, each coupon list contains only one type of coupon (for example, free shipping or 25% discount).

Additional coupons can be added to a list even if the coupon list already contains coupons. Coupons are created in a shop or CRM system as a TXT or CSV file and uploaded to Mapp Engage (see Import Coupons Into a Coupon List​).

The system that creates the coupon regulates the valid use of the coupon during the purchase or order process.

Mapp Engage controls the distribution of coupons to the message recipient (see Add Coupons to a Message​). Each coupon can only be sent one time to one recipient. If the placeholder for a coupon list is inserted multiple times in the same message, the same coupon code is displayed in each location. If several different coupons must be included in a message, the coupons must be inserted from multiple lists.

The way the coupon list is configured determines what Mapp Engage does when there is an insufficient number of coupons in the coupon list:

  • If an alternative text is provided, Mapp Engage automatically sends the alternative text instead of the coupon code.

  • If no alternative text is entered, sendout either pauses or cannot be started. When a coupon is included in a message that is sent to a group, Mapp Engage verifies that there are enough coupons available before the sendout starts. If there are not enough coupons, an error message is generated. Coupon messages that are sent out via automatic activities pause when there are no more coupons in the list. Sendout of the paused message can be resumed once additional coupons are uploaded to the list (see ​Resume Sendout of a Coupon Message​).


  1. In the Main Navigation​, click Content Management​ > Coupon Manager​ .
    ⇒ The ​Coupon Lists Overview​ window opens.
  2. Click the New Coupon List​ button.
    ⇒ The Create New Coupon List​ window opens.
  3. In the Name​ input field, enter a name for the coupon list.
    Enter the name in lowercase letters. Names cannot contain empty spaces or underscores. Special characters and symbols can cause problems and are not recommended. Every coupon list must have a unique name.

  4. In the optional ​Description​ input field, enter a description for the coupon list.
    Descriptions help to identify the coupon list. Descriptions are recommended if multiple coupon lists are in use on a Mapp Engage system.
  5. In the Insufficient Number of Coupons​ area, activate an option to define what happens when there are no coupons available in the list.

    • To replace the coupon with a predefined text and continue message sendout when there are no more coupons available, select Display Alternative Text​.
      When this option is activated, the window adjusts to display a mandatory Alternative Text​ input field.
      Enter or edit the text in the Alternative Text​ input field. The maximum number of characters is 200.

    • To pause the message sendout when there are no more coupons available, select Pause Sendout​ . You can resume the sendout of the paused message once additional coupons are uploaded to the list (see Resume Sendout of a Coupon Message​).

  6. In the Preview Text​ input field, enter the text that replaces the coupon in messages to test recipients and in messages that are used as previews. Actual coupons from the coupon list are never used for test and preview messages. If no preview text is entered, default text is automatically generated from the name of the list.
    The maximum number of characters for the preview text is 200.
  7. In the Remind Owner​ area, specify whether an optional reminder notification is generated when a predefined number of coupons remain in the coupon list.
    Select No​ if you do not want to send notification messages about the number of coupons which remain in a list.
    Select Yes​ to send a reminder to the owner of the coupon list when the remaining number of coupons codes reaches a predefined number.
    ⇒ If the Yes​ checkbox is activated, two input fields for configuring the reminder open:
    In the Send reminder when​ drop-down list, select the number of coupons that, when reached, sends the reminder.
    To send a reminder to someone in addition to the owner, enter their email address in the optional Send Additional Reminder to​ input field. The email address must exist in the Mapp Engage system. The  button opens the Member Search​ window. Enter search criteria to locate a user. Click the  symbol to select a user from the search results.
  8. Click Save​.
    ⇒ The coupon list is created and displayed on the Coupon Lists Overview​ window. To upload coupons to the list, see Import Coupons Into a Coupon List​. To add coupons to a message, see Add Coupons to a Message​.