Skip to content

Coupon Management

Coupons let you create discount codes that customers can apply at checkout. You can offer percentage-based or fixed-amount discounts with various rules and limits.

Viewing Coupons

Go to Admin > Coupons from the admin sidebar. The listing page shows all your coupons with filters for:

  • Search — Find coupons by code
  • Status filter — Show Active, Inactive, or Expired coupons
  • Pagination — Coupons are displayed 15 per page

Each row displays:

  • Coupon code
  • Discount type and value
  • Usage count vs. limit
  • Active/inactive status
  • Expiry date

Creating a Coupon

  1. Go to Admin > Coupons
  2. Click Add Coupon
  3. Fill in the coupon details
  4. Click Save

Coupon Fields

FieldRequiredDescription
CodeYesThe discount code customers enter at checkout (e.g., SUMMER20, FLAT100)
TypeYesPercentage or Fixed amount discount
ValueYesThe discount value — a percentage (e.g., 20 for 20% off) or a fixed amount (e.g., 100 for 100 off)
Minimum Order AmountNoThe minimum order subtotal required to use this coupon
Maximum Discount AmountNoCaps the discount for percentage coupons (e.g., "20% off up to 500 max")
Usage LimitNoTotal number of times this coupon can be used across all customers
Per Customer LimitNoMaximum number of times a single customer can use this coupon
Starts AtNoDate when the coupon becomes valid (leave empty for immediately)
Expires AtNoDate when the coupon expires (leave empty for no expiry)
Is ActiveYesToggle the coupon on or off

Discount Types

Percentage Discount

Takes a percentage off the order subtotal.

Example: A coupon with Type = Percentage and Value = 20 gives 20% off.

  • Order subtotal: 1000
  • Discount: 200 (20% of 1000)
  • Customer pays: 800

Maximum Discount

For percentage coupons, you can set a Maximum Discount Amount to cap the discount. For example, "20% off, up to 500 max" prevents large orders from getting excessively large discounts.

Fixed Discount

Subtracts a fixed amount from the order subtotal.

Example: A coupon with Type = Fixed and Value = 150 gives 150 off.

  • Order subtotal: 1000
  • Discount: 150
  • Customer pays: 850

WARNING

The discount can never exceed the order subtotal. If a customer applies a 500 fixed coupon to a 300 order, the discount will be capped at 300.

Usage Limits

You can control how many times a coupon can be used:

Total Usage Limit

Set the Usage Limit to restrict the total number of redemptions. Once the limit is reached, the coupon can no longer be applied.

Example: A coupon with a usage limit of 100 can be used 100 times total across all customers. The 101st customer who tries to use it will see an error.

Per Customer Limit

Set the Per Customer Limit to restrict how many times a single customer can use the coupon.

Example: A coupon with per customer limit of 1 can only be used once per customer, even if the total usage limit has not been reached.

Coupon Validity

Start and End Dates

  • Starts At — The coupon is not valid before this date. Leave empty if the coupon should be valid immediately.
  • Expires At — The coupon expires after this date. Leave empty if the coupon should never expire.

Active/Inactive Toggle

You can manually enable or disable a coupon at any time using the Is Active toggle, regardless of the start and end dates.

Usage Statistics

On the coupon listing page, you can see the Used Count for each coupon — the number of times it has been redeemed. This helps you track the effectiveness of your promotions.

Editing a Coupon

  1. Go to Admin > Coupons
  2. Click the Edit button on the coupon
  3. Modify any fields
  4. Click Save

TIP

You can change a coupon's rules (minimum order, limits, dates) even after customers have started using it. Changes apply to future uses only.

Deleting a Coupon

  1. Go to Admin > Coupons
  2. Click the Delete button on the coupon
  3. Confirm the deletion

DANGER

Deleting a coupon is permanent. Orders that have already used the coupon will retain their discount in the order history, but the coupon code will no longer be available for new orders.

How Customers Use Coupons

  1. Customer adds items to their cart
  2. At checkout, they enter the coupon code in the discount field
  3. The system validates the coupon (checks active status, dates, limits, minimum order amount)
  4. If valid, the discount is applied and shown in the order summary
  5. The customer completes checkout with the discounted total

Best Practices

  • Use memorable codes — Codes like WELCOME10 or FLAT200 are easier for customers to remember than random strings
  • Set expiry dates — Time-limited coupons create urgency and encourage faster purchases
  • Use minimum order amounts — Requiring a minimum order helps maintain healthy order values (e.g., "10% off orders over 1000")
  • Monitor usage — Check the used count regularly to see which promotions are performing well
  • Deactivate old coupons — Turn off coupons that are no longer part of active promotions

Next Steps

Shop Craft Documentation