Promotions & coupon codes
Promotions are how every discount in your store is expressed — the automatic “free shipping over €50”, the newsletter code, the three-for-two, the trade ladder, the end-of-season sale on one category. They all live on one screen at Marketing → Promotions, and the only thing that makes a discount a coupon is whether you fill in the Code field.
Plans: All plans
Prerequisites
Section titled “Prerequisites”- Nothing for the basic types. Order discounts and free shipping are base features on every plan.
- For product discounts, Buy X get Y, volume pricing and catalog sales: a plan that includes
marketing.promotions.advanced.
Create a promotion
Section titled “Create a promotion”-
Go to Marketing → Promotions and add a promotion.
-
Give it a Title. This is what you and your staff see; it is not shown to shoppers.
-
Decide whether it needs a Code.
- Leave it blank for an automatic promotion that applies to every qualifying order.
- Fill it in —
SUMMER10— to make it a coupon the shopper must type at checkout.
-
Pick the Type (the promotion class) and the Discount method, then enter the Value.
-
Set the limits and window you want — minimum subtotal, dates, usage caps.
-
Set the Status to Active when you want it live, or Scheduled with a start date.
-
Save.
The six promotion types
Section titled “The six promotion types”| Type | What it discounts | Plan |
|---|---|---|
| Amount off order | The order total | All plans |
| Free shipping | The shipping line | All plans |
| Amount off products | Only the lines in scope | Advanced |
| Buy X get Y | Y items once X are bought | Advanced |
| Volume pricing | Per-unit price by quantity tier | Advanced |
| Catalog / collection sale | A whole category or collection | Advanced |
Discount then says how the value is read: Percentage, Fixed amount, Fixed price or Free shipping. Buy X get Y and volume pricing use their own pair — “% off” or “Amount off” — on the quantity they apply to.
Buy X get Y
Section titled “Buy X get Y”Three fields drive it: Buy quantity, Get quantity and Get discount. Three-for-two is buy 2, get 1, get discount 100%. Half price on the second item is buy 1, get 1, get discount 50%.
Volume pricing
Section titled “Volume pricing”Add quantity tiers: a minimum quantity, a discount method and a value, one row per step. Add tier for each break. This is the retail equivalent of a B2B price ladder — the difference being that a promotion applies to everybody, while a price list applies to one company.
Field reference
Section titled “Field reference”| Field | Effect |
|---|---|
| Title | Internal label |
| Code | Blank = automatic; filled = a coupon the shopper enters |
| Status | Draft, Scheduled, Active, Paused or Ended |
| Type | The promotion class — see the table above |
| Discount | Percentage, Fixed amount, Fixed price or Free shipping |
| Value | The number the discount method reads |
| Buy quantity / Get quantity / Get discount | Buy X get Y only |
| Quantity tiers | Volume pricing only: min qty, discount, value |
| Starts at / Ends at | The window in which it applies |
| Min subtotal | The order must reach this before it applies |
| Min quantity | The order must contain this many items |
| Max discount | Caps the discount given — essential on percentages |
| Total uses limit | Redemptions across the whole store |
| Per-customer limit | Redemptions per shopper |
| Stack group | Order, Product or Shipping |
| Limit to category IDs | Comma-separated category IDs; blank applies store-wide |
| First order only | New customers only |
| Logged-in customers only | Excludes guest checkout |
| Apply only to scoped lines | Discounts only the lines in scope, not the order |
Scoping a promotion
Section titled “Scoping a promotion”By default a promotion applies store-wide. Limit to category IDs narrows it — enter the IDs
comma-separated, for example 3, 7, 12. Leaving the field blank applies it everywhere.
Apply only to scoped lines then decides what the discount is calculated on: with it ticked, only the matching lines are discounted; without it, the whole order is, as long as it contains a matching line.
Stacking
Section titled “Stacking”Each promotion sits in a stack group — Order, Product or Shipping — and at most one promotion applies per group. So an order-level discount and free shipping can combine, but two order-level discounts cannot. This is deliberate: it is what stops two independently sensible campaigns from discounting the same order twice.
Statuses
Section titled “Statuses”| Status | Behaviour |
|---|---|
| Draft | Not live; nothing applies |
| Scheduled | Becomes active at Starts at |
| Active | Live now |
| Paused | Temporarily off, keeping its settings and counts |
| Ended | Finished |
Pause rather than delete when a campaign stops. The promotion keeps its redemption count, which is the only record of what the campaign actually cost.
Measuring a promotion
Section titled “Measuring a promotion”Each promotion’s row carries its own analytics: how many times it was redeemed and how much discount it gave in total. Read both together — a high redemption count with a large discount total on a code with no usage cap is the pattern worth catching early.
Common problems
Section titled “Common problems”The promotion does not apply. Check in this order: Status is Active, the current date is inside Starts at/Ends at, the order meets Min subtotal and Min quantity, and no other promotion in the same stack group has already applied.
A coupon code is rejected. The Total uses limit or Per-customer limit has been reached, or First order only is on and the shopper has ordered before, or Logged-in customers only is on and they are checking out as a guest.
A percentage discount gave away far too much. Max discount was blank. Set a cap on every percentage promotion.
The discount hits the wrong lines. Limit to category IDs is blank, or Apply only to scoped lines is not set.
Two discounts should combine but do not. They are in the same stack group. Move one to a different group, if that is genuinely what you want.
An advanced type is not available. Product discounts, Buy X get Y, volume pricing and catalog sales need Retail, Business or Enterprise.
What is the difference between an automatic promotion and a coupon? The Code field. Leave it blank and the discount applies by itself to every qualifying order; fill it in and the shopper must enter that code at checkout. Everything else about the promotion works the same way.
Is there a separate coupons screen? No. A coupon is a promotion with a code, created on the same screen under Marketing → Promotions.
Can two promotions apply to one order? Only across different stack groups. Stack groups are Order, Product and Shipping, and at most one promotion applies per group — so an order discount and free shipping can combine, but two order discounts cannot.
How do I stop a promotion being abused? Use the three limit fields: Total uses limit caps redemptions across the store, Per-customer limit caps them per shopper, and First order only restricts it to new customers.
