Instance · Ecommerce
Ecommerce Discounts Introduction
Last updated 1 November 2026
Lower prices with percentage or fixed discounts, limited by code, products, cart value and uses.
A discount lowers the price a customer pays. It can take a percentage or a fixed amount off, apply to all products or only some products, categories or events, and be limited by a code, a minimum cart value and a number of uses. Use discounts for promotions, member pricing and one-off offers.
Where to find discounts
In the admin, open Ecommerce and choose Discounts. Each discount has its details and a restrictions section.
What a discount holds
| Field | Meaning |
|---|---|
| Name | The name you see in the admin |
| Status | Whether the discount is in use |
| Code | What the customer types to get it |
| Type and value | A percentage or a fixed amount, and how much |
| Applies to | All products, chosen products or categories, or events |
| Minimum cart value | The cart total needed before it applies |
| Usage limit | How many times it can be used in total |
| Usage limit per user | How many times one customer can use it |
| Authorization policy | Limits the discount to people a policy allows, such as members |
From code
The Ecommerce API manages discounts at /ecommerce/api/v2/discounts. Creating one needs a name, a type and what it applies to. A storefront can look a code up with GET /ecommerce/api/v2/discounts/by-code/:discount_code.
Note
The docs instance has no discounts, so none was read. Fields come from the Ecommerce module reference in the Insites Logic Engine.
Common mistakes
- Leaving the usage limit empty on a public code. Anyone who finds it can use it without limit.
- Giving two discounts the same code. A lookup by code then cannot tell them apart.
- Expecting the discount to change past orders. A discount on an order is a snapshot taken when it was applied.