Skip to content

How to create and use coupons

Discount codes and coupon modes, including limits, channels, tiered rewards, and stacking rules.

Overview

Commerce → Promotions → Coupons. Use Add Coupon and pick a mode: Regular Discount Codes, Tiered Discount, Instant Campaign, or Loyalty Perk.

The add/edit form shows How this coupon behaves at the top. That summary updates as you change settings.

Customers use one store coupon per order. Automatic sales can still apply. Couponly credit can also apply on the same order.

Before you start

  • Turn on the coupon’s Sales Channels for where it should work. Tiered Discount applies on Hosted Shopfront and Kiosk. It does not apply on QR Ordering (use a Regular coupon there). See What shows on each channel.
  • Money fields (Coupon Value, Minimum Spend, Min. Order Value, fixed Discount) use your store Currency from Store Settings.
  • Instant Campaign / Loyalty Perk are templates that spawn child codes and cannot be deleted (set inactive instead).

How to use it

List

  1. Open Coupons.
  2. Filters: Campaign Type, Status, Coupon Type, Visibility. Use Apply or Reset.
  3. Columns: Code, Value, Status, Action. A lock icon is Private; an unlock icon is Public. An envelope badge is Email restricted.
  4. Add Coupon (split button) opens the mode you pick. Edit / Delete are on the row. Instant Campaign and Loyalty Perk templates cannot be deleted.

Campaign Type values: Regular, Tiered Discount, Instant Campaign, Loyalty Perk. The list defaults to Regular (non-tiered discount codes).

Add or edit

  1. Coupon Details: Coupon Code (Regular and Tiered), Coupon Type (Fixed or Percentage), Coupon Value (Regular and campaign templates; hidden for Tiered), Description. Campaign templates also have Expires After (Days).
  2. Sales Channels (right column).
  3. Visibility & Display (Regular and Tiered): Visibility Private or Public. Flash Coupon checkbox Show as flash coupon on shopfront (public coupons only). Tiered Visibility is locked to Public.
  4. Apply Coupon To (Regular and Tiered): Products, Categories, Email Address. Leave all empty so the coupon applies to all items. Select opens product/category pickers.
  5. Schedule: Start Date, End Date (store local calendar).
  6. Limits: Min. Order Value (not shown for Tiered), Max. Redemptions, Max. Redemptions Per Customer, First Order Only (No - allow on any order or Yes - limit to first online order). On Kiosk and QR Ordering, per-customer and first-order limits use the email the guest enters at checkout; Apply Coupon To → Email Address requires that same email when they apply the code.
  7. Save.

Tiered Discount

On Reward Tiers, set spend thresholds, a Discount per tier, and optional Free Products. The form hint says customers choose the discount or one product from the list. That choice is coming soon on Hosted Shopfront. Kiosk uses the Discount. QR does not use Tiered Discount.

  1. Start from Add Coupon → Tiered Discount.
  2. Add 2–10 tiers with Add Tier. Each row: Minimum Spend, Discount, Free Products (click the field → Select Free Products). Remove extra rows with the close control.
  3. Spend thresholds must increase from one tier to the next. Lowest Minimum Spend is the coupon’s minimum order (there is no Min. Order Value field).
  4. Optionally pick up to 3 free products per tier. These are a reward choice, not the Apply Coupon To targeting list. Free Products are for Hosted Shopfront (coming soon). Kiosk always uses the tier Discount. QR Ordering does not use tiered coupons.
  5. Only one active tiered coupon per store. Deactivate the existing one before creating or activating another.

Understanding the options

Mode On-screen description
Regular Discount Code Standard coupon codes that can be public or private.
Tiered Discount Public spend-based tiers; only one active tiered coupon per store.
Instant Campaign Private template for auto-generated campaign coupons. Fixed code INSTANTCAMPAIGN.
Loyalty Perk Private template for loyalty coupons generated for customers when they place an order. Fixed code LOYALTYPERK.

Public coupons can appear for customers (for example shopfront unlock discounts). Flash is a public coupon shown in the shopfront flash strip.

Email Address limits redemption to that customer email. First-order and per-customer limits also use email, not phone.

How a tiered coupon applies at checkout

Channel What customers get
Hosted Shopfront Highest matching tier Discount. Spend progress shows when Cart Placement is Bottom checkout strip. Choosing a Free Products reward instead of the discount is coming soon.
Kiosk Highest matching tier Discount. No free-product choice.
QR Ordering Tiered Discount is not available. Use a Regular coupon on the QR channel.
  • Eligible cart spend unlocks the highest matching tier automatically.
  • Eligible spend follows Apply Coupon To: all items, or only the products/categories you selected.
  • When a shopper takes a Free Products reward (Hosted Shopfront, coming soon), credit is one unit of that line. The product must already be in the cart, as a single line. Otherwise the order uses that tier’s Discount.
  • A free reward line on the order shows Free reward x 1. See View orders.

Important

  • One coupon code per checkout.
  • Instant Campaign can also be created from the seller mobile app.
  • Child codes from Instant/Loyalty cannot change their code.
  • Email-restricted coupons need a matching customer email at checkout. Guests without that email cannot use the code.
  • Only one active tiered coupon is allowed per store.
  • Checking QR Ordering on a tiered coupon does not make it work in the QR app yet.
  • Coupons reduce merchandise. They do not reduce the platform fee. See Order totals.

Common problems

Problem

Coupon not accepted.

What to check

  1. Dates, Status, and Sales Channels.
  2. Min. Order Value / lowest tier Minimum Spend, and Apply Coupon To targeting.
  3. Max. Redemptions, Max. Redemptions Per Customer, First Order Only, Email Address.
  4. Another active Tiered Discount blocking a new one.
  5. Channel: QR does not accept Tiered Discount. Kiosk will not offer Free Products (it applies the discount only).

Problem

Cannot delete Instant Campaign.

Solution

Expected. Set it inactive instead.