Discount coupons
Route: /org/ecom/storesettings?tab=coupons · Permission: Manage Story Front Coupon Codes
1. What a coupon is
A code a shopper enters at checkout to reduce what they pay. Each coupon carries a discount, an optional expiry, a minimum order value, and — importantly — three independent audience filters.
Manage Story Front Coupon Codes is separate from manage. A user without it does not see a
disabled section — the rail has no Discount coupons entry at all.
2. How a coupon is evaluated
3. The section
4. Field reference
| Field | Control | Notes |
|---|---|---|
| Discount type | Select | percentage or flat |
| Valid till | Date | Optional — empty means no expiry |
| Minimum order value | Number | Below this, the code is refused |
| Valid for customers | Multi-select | Specific customers |
| Valid for products | Multi-select | Specific products or packages |
| Valid for categories | Multi-select | Specific categories |
| Active | Toggle | Off disables without deleting |
The three audience filters combine
They are stored as three separate lists. Leaving all three empty makes the coupon available to everyone, on everything — which is the default and is rarely what a targeted campaign wants.
A coupon created without touching the three selectors applies to every customer and every product. For a single-customer goodwill code, the customer list must be set explicitly.
Where the options come from
| Filter | Source |
|---|---|
| Customers | The project's customers |
| Products / packages | Inventory products and packages |
| Categories | Product categories |
5. The admin contract
| Prerequisite | Without it |
|---|---|
| Manage Story Front Coupon Codes | The section is hidden |
| Products, categories, customers | The restriction selectors are empty |
| A currency | Flat discounts have no unit |
6. Downstream
Coupons are consumed at checkout and recorded on the resulting order.
7. Don't confuse this with…
| Thing | Where | Why |
|---|---|---|
| Coupon | Here | A code the shopper enters |
| Free shipping threshold | Location & delivery | Automatic, no code |
| Free delivery radius | Location & delivery | Distance-based, no code |
| Refund | Refunds | Money back after the fact |
8. Troubleshooting
| Symptom | Cause |
|---|---|
| No Discount coupons in the rail | Missing managecoupons |
| A code is refused | Inactive, expired, under the minimum, or outside its audience filters |
| A code works for everyone | The restriction lists are empty |
| Discount smaller than expected | Percentage against a subtotal that excludes shipping |