Create Coupons

Learn how to create and configure coupon rewards in CleverTap to offer discounts, cashback, or partner incentives as part of your promotional campaigns.

Overview

The Create Coupon page allows you to define, configure, and launch coupon-based rewards tailored to your business goals. You can create single or bulk coupon codes, set up reward types, define redemption limits, and control visibility and expiration settings.

Coupons created through this flow can be used in Promo Campaigns, distributed via user actions, or uploaded in bulk for manual assignment.

Create Coupon

To create a coupon, go to Promotions > Rewards > Coupons, and click Create Coupon. The entire process is divided into the following three key steps:

  1. Select Coupon Type
  2. Select Reward Effect
  3. Configure Coupon Settings

Select Coupon Type

Select how you want to distribute the coupon codes to your users based on your engagement strategies, then click Next to continue.

  • Single code for all users: A single coupon code that can be used by all users without eligibility criteria. This includes new visitors and existing users. For example, use code CHRISTMAS20 to get 20% off on your entire orderβ€”no sign-up, login, or purchase history required. This type of code is ideal for platform-wide promotions such as festive sales, homepage banners, or email campaigns targeting a broad audience.

  • Single code based on user actions: A single coupon code that is distributed through Promo campaigns when users meet specific qualifying conditions, such as signing up, completing a purchase, or reactivating after a period of inactivity. For example, use code WELCOME100 to get $100 cashback on your first order. This type of coupon is best used for milestone-based campaigns such as onboarding, re-engagement, or referral rewards, ensuring the reward is tied to meaningful user actions.

  • Downloadable bulk unique codes: Unique, one-time-use codes that can be redeemed by any userβ€”no eligibility criteria required. These are generated in bulk using customizable code formats (for example, alphanumeric), with optional prefix, suffix, and length settings. For example, generate 10,000 unique codes such as SAVE25XYZ, which are then distributed via any partner platform. This type of coupon is ideal for offline promotions, printed flyers, or third-party channels where you want to restrict each user to a single redemption without needing system-based user segmentation.

  • Bulk unique codes based on user actions: One-time-use codes that are automatically assigned to users who meet specific conditions defined in a linked Promo campaign. The system selects and assigns a unique code from the coupon pool when the user qualifies. For example, assign a unique code to each user who completes three purchases in a loyalty campaign. The code is automatically issued once the condition is met and can be redeemed only once by that user. This type of coupon is ideal for personalized reward journeys or limited inventory campaigns where you want to control distribution based on behavioral triggers.

The preview panel provides a representative visualization of each selected coupon type, helping you understand how the coupon will appear and function for users.

Select Coupon Type from the Available Types

Select Coupon Type from the Available Types

Select Reward Effect

Define where the coupon discount will be applied within the order and click Continue to configure coupon settings:

  • Entire Order: Applies the discount to the total order value. For example, a coupon offering 20% off on an order worth $250 results in a $50 discount. The user pays $200.

  • Specific Products: Applies the discount only to selected products in the cart. For example, a coupon offering 30% off on jackets, where the cart includes a jacket ($2,000) and shoes ($3,000). The discount applies only to the jacket (30% of $2,000 = $600). The final payable amount is $4,400.

  • Custom Order Property: Applies the discount to a custom property such as platform fees, convenience fees, or surge charges. For example, a coupon offering 50% off on platform fees. If the order subtotal is $2,000 and the platform fee is $200, the user gets a $100 discount, reducing the total payable amount to $2,100.

The preview panel displays a visual breakdown of how the coupon is applied, including itemized pricing, discount amount, and final total.

Select Reward Effect for a Coupon

Select Reward Effect for a Coupon

Configure Coupon

Key Details

Define the core identity and structure of your coupon. The following table outlines each available field, its purpose, and the coupon types it applies to.

FieldDescriptionSingle CodeBulk Unique Codes
Coupon codeA static code users apply at checkout (for example, FLAT500).βœ…β€“
Coupon nameInternal name to identify the coupon set (for example, FLAT_APRIL_2025).β€“βœ…
Code formatChoose the format for generated codes: Numeric, Alphabetic, or Alphanumeric.β€“βœ…
Code lengthSet the number of characters for each generated code.β€“βœ…
Number of codesTotal number of unique codes to generate (for downloadable bulk codes).β€“βœ…
Prefix/SuffixAdd optional text before or after the generated code for tracking or branding.β€“βœ…
Coupon descriptionA short description of the offer shown to users or used internally.βœ…βœ…
Terms & ConditionsDefine restrictions or usage notes such as "One-time use only" or "Cannot be combined."βœ…βœ…
Coupon visibilityToggle ON to make the coupon code visible to users in the coupon trayβœ…βœ…

You can preview how the coupon will appear in the user’s coupon tray.

πŸ“˜

Coupon Preview

The preview panel on the right provides a visual representation of how the coupon will appear in the user’s coupon tray. This is only a sample and may not reflect the exact in-app appearance. To customize the tray layout, refer to Fetch Coupon API.

Reward

Choose where the reward should be applied within the user’s order. This determines which part of the cart or transaction the discount or cashback will target as follows:

Define Reward Scope

Define Reward Scope

Reward Effect

Each Reward effect provides additional configuration options as follows

Reward EffectDescriptionUnique Configuration Options
Entire OrderApplies the reward to the total value of the order.Exclude products: Enable this option to exclude certain products from the coupon discount. For example, if you select exclude itemName = iPhone 15 and if a cart contains iPhone 15 and AirPods, only the AirPods value will be considered for discount calculation.
Specific ProductsApplies the reward only to selected products in the cart.
  • Product Filters: Define which products are eligible for the reward based on attributes such as itemName or category. You can apply multiple filters using AND/OR logic. Additionally, you can use custom catalog properties from your product catalog to define business-specific filters.
  • Qualifying rules: Once eligible products are identified using filters, you can define qualifying rules that determine when the reward should apply. These rules are evaluated only against discount-eligible items and include:
    • itemsTotalQuantity: The total number of eligible items in the cart.
    • itemsSaleAmount: The total sale value of eligible items, calculated as unit price Γ— quantity.
    You can combine these rules using AND or OR to specify whether all conditions must be met or just any single is sufficient.
  • Custom Order PropertyApplies the reward to a specific order-level property.Applicable property: Choose a custom field such as platform fee or shipping cost

    Once you select the reward scope, you can define the reward details such as Reward type and Discount value.

    Reward Type

    The following are the options available for the Reward types dropdown on the CleverTap dashboard:

    Reward TypeDescriptionSupports Max Cap
    Fixed discountOffers a flat reduction in the order amount. For example, enter 200 to give users $200 off on their purchases.No
    Percentage discountApplies a percentage-based discount to the order. For example, enter 15 to give users a 15% discount on their purchase.Yes
    Fixed cashbackGives fixed cashback points to the user wallet or account. For example, enter 100 to credit $100 cashback points to the user after a successful transaction. It also requires selecting the target Loyalty wallet, where the cashback will be credited.No
    Percentage cashbackCredits cashback points based on a percentage of the order total. For example, enter 10 to provide 10% of the order value as cashback points. It also requires selecting the target Loyalty wallet where the cashback will be credited.Yes

    πŸ“˜

    Max Cap for Percentage Rewards

    For percentage-based rewards, you can optionally set a maximum cap by clearing the Unlimited discount per order or Unlimited cashback per order checkbox.

    For example, 10% discount with a cap of $100 means if the order total is $1500, the discount applied will be $100 max.

    Discount Value

    Enter either the fixed amount or the percentage to be applied based on the selected reward type. For cashback rewards, ensure a loyalty wallet is selected.

    Example

    Consider an example to understand how the Reward configuration works. You want to offer a 20% discount on T-shirts, but only when a user buys at least two items from that category.
    In this case,

    • Product filters: Set category = T-shirts to limit the reward to T-shirt purchases.
    • Qualifying rule: Define itemsTotalQuantity β‰₯ 2 to ensure the discount applies only when the user adds two or more T-shirts to their cart.
    • Reward type: Choose Percentage discount.
    • Discount value: Enter 20% and optionally set a maximum cap (for example, $50) by disabling the Unlimited discount per order checkbox.

    Qualifying Rules

    Define the conditions under which a coupon becomes applicable. You can apply rules based on cart properties, product-level attributes, or user profile traits. Multiple conditions can be combined using AND/OR logic to build flexible eligibility criteria.

    Define Qualifying Rules for the Coupon

    Define Qualifying Rules for the Coupon

    Cart

    Define eligibility based on cart-level attributes such as total sale amount or item count. You can add multiple cart properties with different operators, such as equals, greater than, less than, between and. You can combine multiple conditions using AND to enforce all rules, or OR to allow any rule to trigger coupon eligibility.

    For example, if a user adds 2 T-shirts priced at β‚Ή150 each and a cap priced at β‚Ή250 (total β‚Ή550), the coupon is applicable.

    Add Qualifying Rules for Cart

    Add Qualifying Rules for Cart

    Product

    Apply the coupon on product properties with two available modes. You can add multiple product property rules and combine them with AND/OR conditions as needed.

    Let us consider an example to understand this better. A fashion retailer wants to offer 15% OFF on winter wear items such as jackets, sweaters, and hoodies, all from the brand ArcticEdge. The product filters are:

    • productCategory = Jackets OR Sweaters OR Hoodies
    • brand = ArcticEdge

    It supports the following two modes:

    • Any of: The coupon applies if at least one item in the cart meets the filters above. In this case, if the cart contains 1 ArcticEdge sweater + 1 regular t-shirt, the coupon applies (sweater qualifies)`.

    • Each of: The coupon applies only if all items in the cart match the filters. In this case, if the cart contains 2 ArcticEdge jackets + 1 ArcticEdge hoodie, the coupon applies (all items match).

    Add Qualifying Rules for Product

    Add Qualifying Rules for Product

    User Property

    Restrict coupon applicability to users who match specific profile attributes. You can configure multiple user properties combined using AND/OR conditions to target the right audience precisely. These conditions ensure that the coupon is visible and redeemable only for eligible users based on attributes available in their user profile.

    For example, A food delivery app wants to offer a $50 OFF coupon exclusively to users located in India.

    Add Qualifying Rules for User Property

    Add Qualifying Rules for User Property

    πŸ“˜

    Note

    The User Property rule is available only for All Users coupons.

    Validity

    Configure when the coupon will become active and remain available to users. Validity settings vary based on the coupon type.

    For All Users Coupons

    These include the following coupon types: Single code for all users or Downloadable bulk unique codes. Set the following parameters to define the active window for the coupon:

    • Timezone: The system uses your default account timezone, for example, GMT +05:30 Asia/Kolkata.
    • Time Period:
      • Start date and time: Define when the coupon becomes active. For example, if the start time is 1st July 2025 at 10:00 AM, users will only be able to view and redeem the coupon from that moment onward. The start date is derived from promo campaigns based on when the coupon is being rewarded to the user.
      • End date and time: Choose when the coupon expires. Set a specific time, for example, 31st July 2025 at 11:59 PM) or select Never ends for ongoing availability.
    Set Validity for All User Coupons

    Set Validity for All User Coupons

    For User Actions-Based Coupons

    These include the following coupon types: Single code based on user actions or Bulk unique codes based on user actions.

    These coupons become active when assigned through a Promo Campaign and support only relative expiry settings:

    • Coupon expiry: Define how long the coupon remains valid after it is assigned. For example, 7 days after the coupon was rewarded. You can select from minutes, hours, days, or weeks. Select Never for coupons with no expiry.
    Set Validity of User Action Based Coupons

    Set Validity of User Action-Based Coupons

    Custom Schedule

    Use this option to restrict when a coupon can be redeemed during the day or week, regardless of the overall start or end time. This feature is available for all coupon types. It is especially useful for time-sensitive promotions, for example, Happy hour discounts, Weekend-only deals, Midnight or lunchtime offers and so on.

    You can define:

    • Specific days of the week (for example, Saturday, Sunday)
    • Specific time slots (for example, 12:00 PM – 3:00 PM)

    This ensures the coupon is only redeemable during those selected windows, even if it’s otherwise valid.

    Redemption Limits

    Configure how many times a coupon can be redeemed globally and per user. These settings help prevent overuse and ensure budget control.

    πŸ“˜

    Redemption Limits Rules

    • Redemption limits can be configured only for single code coupons (both all user and user action based).
    • For bulk code coupons (both downloadable and user action based codes), the code-level and user-level redemption limits are fixed to one. This is because each bulk coupon code is unique and designed for one-time use by a single user, ensuring exclusivity and preventing misuse.

    Code Level Limits

    Set the total number of times a coupon code can be redeemed globally across all users. The default is unlimited but you can also change the total limit to X times.

    • Daily limit: Maximum number of redemptions allowed per day. For example, 100 redemptions per day.
    • Weekly limit: Maximum number of redemptions allowed per week. For example, 500 redemptions per week.
    • Monthly limit: Maximum number of redemptions allowed per month. For example, 2000 redemptions per month.
    Set Code Level Limits

    Set Code Level Limits

    User Level Limits

    Set the number of times each user can redeem the coupon. The default total limit is set to one use per user, but you can change it to unlimited or click Add Limit to customize:

    • Daily limit: Redemptions allowed per user per day. For example, 1 redemption per user per day.
    • Weekly limit: Redemptions allowed per user per week. For example, 2 redemptions per user per week.
    • Monthly limit: Redemptions allowed per user per month. For example, 4 redemptions per user per month.
    Set User Level Limits

    Set User Level Limits

    Redemption Logic

    When a user attempts to redeem a coupon, the system validates:

    • Whether the coupon is active and within the validity period
    • Whether the coupon meets all qualifying rules (cart, product, user property)
    • If Single Code Coupon:
      • Ensure the global code-level limit has not been exceeded
      • Ensure the user has not exceeded their redemption quota
    • If Bulk Code Coupon:
      • Ensure the unique code hasn’t been used before

    If all checks pass, the coupon is successfully applied.

    Best Practices

    The following are the best practices when creating coupons:

    • Use percentage discounts for small purchases and flat discounts for high-value items.
    • Set expiry dates to create urgency.
    • Use cart-based conditions to increase order value.
    • Track coupon performance regularly and adjust campaigns accordingly.
    • Avoid excessive stacking to prevent revenue loss.