Skip to main content
Version: 1.0.0

Coupons

Coupons are promotional tools used in a commerce store to offer discounts or incentives to customers. They are typically provided as codes that customers can apply during checkout to receive a specific benefit, such as a discount on their total order, free shipping, or other rewards.

In this section, we’ll take a look at how to use the Coupons in your Craft CMS control panel.

1. General Settings​

Coupon Name​

  • What it is: The name of the coupon or promotion.
  • How to use it:
    Example: Enter "Summer Sale 2025" to indicate that the coupon is for a summer promotion.

Coupon Type​

Choose the type of coupon you want to create by selecting one of the following options:

Coupon TypeWhat It MeansExample
Specific CouponA single, fixed coupon code that customers enter at checkout.Code: "SAVE20"
Dynamic CouponAutomatically generates multiple unique coupon codes based on your settings.Generates 100 codes following a defined pattern (e.g., "PROMO-XXXXXXXX").

Depending on your choice, additional fields will appear:

  • For Specific Coupon, you'll provide a Coupon Code directly.
  • For Dynamic Coupon, you'll configure the format, quantity, length, prefix/suffix, and dash settings.

For a Specific Coupon​

  • Coupon Code:
    • What it is: The exact code that customers must enter.
    • Example: Enter "SAVE20".

For a Dynamic Coupon​

Configure the following fields to automatically generate multiple coupon codes:

  • Format:

    • What it is: The pattern or structure for the generated codes.
    • Example: Select a format like "XXXX-XXXX" (e.g., "ABCD-EFGH").

  • Coupon Quantity:

    • What it is: The total number of coupon codes to generate.
    • Example: Enter "100" to generate 100 unique codes.

  • Coupon Length:

    • What it is: The number of characters in the main part of each code (excluding any prefix, suffix, or dashes).
    • Example: Enter "10" to set each core code to 10 characters.

  • Prefix and Suffix:

    • What they are: Optional text added before (prefix) or after (suffix) the main code.
    • Example: A prefix "PROMO-" would make the codes appear as "PROMO-XXXXXXXX".

  • Dash Every X Characters:

    • What it is: Automatically insert a dash (-) at regular intervals.
    • Example: Enter "4" so a code like "ABCD1234EF" is formatted as "ABCD-1234-EF".
      Leave this field blank if you prefer a continuous string.

2. Discount Settings​

Decide the type and value of the discount your coupon will offer.

Discount Type​

Select whether the discount is a fixed amount off or a percentage off.

Discount TypeHow It WorksExample
FixedA set amount is subtracted from the order total.Enter "20" to deduct 20€ from the total purchase.
PercentageA percentage is subtracted from the order total.Enter "20" to offer a 20% discount on the order.

Discount Amount​

  • How to use it:
    Example:
    • For a fixed discount, enter "20" to deduct 20€.
    • For a percentage discount, enter "20" to offer a 20% discount.

3. Restrictions and Validity​

Set the parameters for when and on which orders the coupon can be applied.

Validity Period​

  • Date From:
    • What it is: The start date when the coupon becomes active.
    • Example: Enter "2025-06-01" if the coupon should start on June 1, 2025.
  • Date To:
    • What it is: The expiration date of the coupon.
    • Example: Enter "2025-06-30" to have the coupon expire on June 30, 2025.

Grand Total Restrictions​

Define the minimum and maximum order totals for the coupon usage.

  • Minimum Grand Total:
    • What it is: The minimum purchase amount required.
    • Example: Enter "50" to require orders of 50€ or more.
  • Maximum Grand Total:
    • What it is: The maximum purchase amount eligible for the coupon.
    • Example: Enter "500" to restrict the coupon to orders up to 500€.
IMPORTANT

The Maximum Grand Total must be greater than the Minimum Grand Total. If the maximum is lower than the minimum, the coupon will not work as expected.

Site Selection​

  • What it is: If you manage multiple sites, choose the site where the coupon will be active.
  • Example: Select "Main Site" if the coupon is intended for your primary website.

Step-by-Step​

  1. General Settings:

    • Coupon Name: Enter a descriptive name (e.g., "Winter Promo 2025").
    • Coupon Type:
      • For a Specific Coupon, enter the Coupon Code (e.g., "WINTER20").
      • For a Dynamic Coupon, set the Format, Coupon Quantity, Coupon Length, Prefix, Suffix, and Dash Every X Characters.

  2. Discount Settings:

    • Discount Type: Choose either Fixed or Percentage.
    • Discount Amount: Enter the discount value (e.g., "20").

  3. Restrictions and Validity:

    • Validity Period: Specify the start and end dates.
    • Grand Total Restrictions:
      • Enter the minimum (e.g., "50") and maximum (e.g., "500") order totals.
      • Remember: The maximum must be greater than the minimum.
    • Site Selection: Choose the site for the coupon.

  4. Save Your Coupon:

    • Ensure all required fields are filled out.
    • Click the save button to finalize your coupon settings.

By following these steps, you can easily create and manage coupons for your website.