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

# Use a Coupon List in a Campaign

> Distribute unique single-use coupons through email, push, and other MoEngage campaigns. Add Jinja coupon references so each user gets a unique code.

After adding coupons to MoEngage, you can start including them in your messages sent via campaigns and Flows.

MoEngage currently supports sending coupons via the following messaging channels:

| Channel Name  | Message Sent via Campaign | Message sent via Flows |
| ------------- | ------------------------- | ---------------------- |
| Mobile Push   | Yes                       | Yes                    |
| Web Push      | Yes                       | Yes                    |
| Email         | Yes                       | Yes                    |
| SMS           | Yes                       | Yes                    |
| WhatsApp      | Yes                       | Yes                    |
| Mobile In-App | Yes                       | Yes                    |

You can follow the process outlined hereafter to add the coupons to your campaigns. This article guides you through the process of creating coupon-based email marketing campaigns. You can follow a similar approach to add coupon references in other campaign channels.

<Info>
  Create the Coupon list you intend to use in the campaign before following the steps mentioned below. You can use only the active Coupon list in campaigns. Learn how to [create coupons](/user-guide/content/coupons/add-coupons-to-moengage).
</Info>

At MoEngage, creating an email campaign is a three-step process.

1. Target users
2. Content
3. Schedule and goals

You will add the Jinja reference for the Coupon list in the second step 'Content'. This applies whether you are using the Drag and Drop Email editor of MoEngage or your own Custom HTML template.

# Create an Email Campaign with Coupons

To create an Email campaign with coupons, perform the following steps:

1. On the sidebar menu in MoEngage, hover over the Engage menu item <img alt="Screenshot 2025-06-04 at 4.32.53 PM.png" src="https://mintcdn.com/moengage/tNrQQROY8O0h4yWe/images/moengage_15bde3.png?fit=max&auto=format&n=tNrQQROY8O0h4yWe&q=85&s=0f8dbf27d001625e70e962ec8ad9a2a2" width="38" height="32" data-path="images/moengage_15bde3.png" /> . The **Engage** menu appears.
2. Click **+ New Campaign**. <img src="https://mintcdn.com/moengage/60BzFdXTJDO5dnCb/images/moengage_3284e8.png?fit=max&auto=format&n=60BzFdXTJDO5dnCb&q=85&s=faa90716e0e3a7c0e42730f26bb75791" alt="1.png" width="562" height="474" data-path="images/moengage_3284e8.png" /> You can also click **All Campaigns** on the **Engage** menu and then click **+ Create campaign** on the All campaigns page.
3. On the **New Campaign** dialog box, under **OUTBOUND**, click **Email**.
4. Click \*\*Periodic \*\*campaign, and you can follow the same steps for any other email campaign type. For more information about delivery types, refer to [Delivery Types](/user-guide/campaigns-and-channels/getting-started/introduction/delivery-types-moengage-channels). <img src="https://mintcdn.com/moengage/_eUNBDpGCEXI_sgZ/images/moengage_a4e402.png?fit=max&auto=format&n=_eUNBDpGCEXI_sgZ&q=85&s=147a14e9387a4d3e603b8dfcfa43fa0b" width="970" height="1092" data-path="images/moengage_a4e402.png" />
5. In step 1, *Target users*, enter the basic campaign details and define the audience and click **Next**.
6. In step 2, *Content*, enter a subject and other basic campaign details and scroll down to the **Template Editor** section.
7. If you are creating content using the **Drag and drop editor**:
   * Start with your saved template, blank template, or a template from the pre-built templates section that can be customized as desired.
   * Customize the template by adding your branding elements, images, and text. You can also personalize the email content using dynamic variables. For more information, refer to [How to use the Template editor.](/user-guide/campaigns-and-channels/email/create/create-content-with-the-drag-and-drop-editor)
   * Select the text section where you want to place the coupon code reference in the email body and click **New way to Personalize**. <img src="https://mintcdn.com/moengage/S2vOz7ciYYqlhjCf/images/moengage_6d3253.png?fit=max&auto=format&n=S2vOz7ciYYqlhjCf&q=85&s=6d794553bacecff1cb27dd19bc5ec964" width="2880" height="1530" data-path="images/moengage_6d3253.png" />
   * In the Email Personalization dialog box, on the **Coupons** tab, search for the coupon list from which you want to retrieve the coupons.\
     An alert icon will appear if the coupon count in the list is below the defined shortage threshold of coupon list settings. It's a prompt to check audience size, coupon count, and restock before sending the campaigns. <img src="https://mintcdn.com/moengage/wIFGWsQFEjsz2j4v/images/moengage_e04164.png?fit=max&auto=format&n=wIFGWsQFEjsz2j4v&q=85&s=bb610a1802bb4e285be6ee4b4bba579a" width="2880" height="1616" data-path="images/moengage_e04164.png" />
   * Select the coupon list and choose a fallback to define what happens if the coupon list doesn't retrieve coupons. Selecting **Do not send Email** will stop any email from being delivered without the coupon code. You can also use a static fallback coupon code as an alternative.
   * Click **Done.** This action adds the Jinja reference in the selected text section of your email body as desired.\
     You can also paste the personalization snippet here directly.
     * Jinja reference for a coupon list without a fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']}}
       ```
     * Jinja reference for a coupon list with the *Do not send* fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('MOE_NOT_SEND')}
       ```
     * Jinja reference for a coupon list with static fallback coupon code:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('YOUR-STATIC-CODE')}}
       ```
   * Further, you can add a style to highlight the coupon code within the email body. <img src="https://mintcdn.com/moengage/CaPmX0z_ys8cr0ms/images/moengage_07b705.png?fit=max&auto=format&n=CaPmX0z_ys8cr0ms&q=85&s=9f0ebc078816e7e2c53cded552f02e37" width="2880" height="1610" data-path="images/moengage_07b705.png" />
8. If you are creating content using the **Drag and drop editor**:
   * Start with your saved template, blank template, or a template from the pre-built templates section that can be customized as desired.
   * Customize the template by adding your branding elements, images, and text. You can also personalize the email content using dynamic variables. For more information, refer to [How to use the Template editor.](/user-guide/campaigns-and-channels/email/create/create-content-with-the-drag-and-drop-editor)
   * Select the text section where you want to place the coupon code reference in the email body and click **New way to Personalize**. <img src="https://mintcdn.com/moengage/S2vOz7ciYYqlhjCf/images/moengage_6d3253.png?fit=max&auto=format&n=S2vOz7ciYYqlhjCf&q=85&s=6d794553bacecff1cb27dd19bc5ec964" width="2880" height="1530" data-path="images/moengage_6d3253.png" />
   * In the Email Personalization dialog box, on the **Coupons** tab, search for the coupon list from which you want to retrieve the coupons.\
     An alert icon will appear if the coupon count in the list is below the defined shortage threshold of coupon list settings. It's a prompt to check audience size, coupon count, and restock before sending the campaigns. <img src="https://mintcdn.com/moengage/wIFGWsQFEjsz2j4v/images/moengage_e04164.png?fit=max&auto=format&n=wIFGWsQFEjsz2j4v&q=85&s=bb610a1802bb4e285be6ee4b4bba579a" width="2880" height="1616" data-path="images/moengage_e04164.png" />
   * Select the coupon list and choose a fallback to define what happens if the coupon list doesn't retrieve coupons. Selecting **Do not send Email** will stop any email from being delivered without the coupon code. You can also use a static fallback coupon code as an alternative.
   * Click **Done.** This action adds the Jinja reference in the selected text section of your email body as desired.\
     You can also paste the personalization snippet here directly.
     * Jinja reference for a coupon list without a fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']}}
       ```
     * Jinja reference for a coupon list with the *Do not send* fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('MOE_NOT_SEND')}
       ```
     * Jinja reference for a coupon list with static fallback coupon code:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('YOUR-STATIC-CODE')}}
       ```
   * Further, you can add a style to highlight the coupon code within the email body. <img src="https://mintcdn.com/moengage/CaPmX0z_ys8cr0ms/images/moengage_07b705.png?fit=max&auto=format&n=CaPmX0z_ys8cr0ms&q=85&s=9f0ebc078816e7e2c53cded552f02e37" width="2880" height="1610" data-path="images/moengage_07b705.png" />
9. If you are creating content using the **Custom HTML editor**:
   * Paste or import your HTML code into the editor.
   * Select the text area where you want to place the coupon code reference and type @.
   * In the Email Personalization dialog box, on the **Coupons** tab, search for the coupon list from which you want to retrieve the coupons.\
     An alert icon will appear if the coupon count in the list is below the defined shortage threshold of coupon list settings. It's a prompt to check audience size, coupon count, and restock before sending the campaigns. <img src="https://mintcdn.com/moengage/wIFGWsQFEjsz2j4v/images/moengage_e04164.png?fit=max&auto=format&n=wIFGWsQFEjsz2j4v&q=85&s=bb610a1802bb4e285be6ee4b4bba579a" width="2880" height="1616" data-path="images/moengage_e04164.png" />
   * Select the coupon list and choose a fallback to define what happens if the coupon list doesn't retrieve coupons. Selecting **Do not send Email** will stop any email from being delivered without the coupon code. You can also use a static fallback coupon code as an alternative.
   * Click **Done.** This action adds the Jinja reference in the selected text section of your email body as desired.\
     You can also paste the personalization snippet here directly.
     * Jinja reference for a coupon list without a fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']}}
       ```
     * Jinja reference for a coupon list with the *Do not send* fallback:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('MOE_NOT_SEND')}
       ```
     * Jinja reference for a coupon list with static fallback coupon code:
       ```json wrap theme={null}
       {{Coupons.CouponListName['Black_Friday_Coupons']|default('YOUR-STATIC-CODE')}}
       ```
10. After the setup is complete, click **Preview** to ensure it appears as intended. <img src="https://mintcdn.com/moengage/BlcsVkkZu61NB-XQ/images/moengage_4a454e.png?fit=max&auto=format&n=BlcsVkkZu61NB-XQ&q=85&s=a6cc257b0c0ac7b6443db63504cfa1f5" width="2860" height="1524" data-path="images/moengage_4a454e.png" />
11. You can also deliver a test campaign to ensure end-to-end delivery before scheduling it for all users. <img src="https://mintcdn.com/moengage/37Js42lPMANg-cwG/images/moengage_fedf4b.png?fit=max&auto=format&n=37Js42lPMANg-cwG&q=85&s=2d683bcd3d5980d28d808208127e6685" width="2684" height="472" data-path="images/moengage_fedf4b.png" />
12. After the content setup with the coupon list is complete, click **Next** to move to step 3 of campaign setup, *Schedule and Goals*.
13. Configure the appropriate schedule and goals, and publish the campaign.

<Info>
  * A campaign that uses single-use coupons can have throttling up to a maximum of 100K PRM.
  * To ensure that coupons are not wasted during preview and test, the preview section and test campaign lock only one of the coupons from the coupon list for all test users.
  * The coupon shown in the preview or test campaign is not marked as used. Hence this coupon will be available to be distributed in the live campaign.
</Info>
