Skip to content

Instance · Ecommerce

Managing Discounts

Last updated 1 November 2026

Update or delete a discount, or turn it off and keep its history.

Change a discount when an offer changes: a new end to a promotion, a higher usage limit or a different set of products. Delete it when the offer is over and nobody will use the code again. Orders already placed keep the discount they had.

Update a discount

  1. In the admin, open Ecommerce and choose Discounts.
  2. Find the discount and open it to edit.
  3. Make your changes on the details or the restrictions.
  4. Save.

Delete a discount

  1. Open Ecommerce, then Discounts.
  2. Find the discount and choose to delete it.
  3. Confirm.

What you can change

FieldNotes
StatusTurn a discount off without deleting it
CodeWhat customers type. Keep codes unique
Type and valuePercentage or fixed amount
Applies toAll products, chosen products or categories, or events
Minimum cart valueThe cart total needed
Usage limit and per-user limitHow often it can be used
Authorization policyLimit it to people a policy allows

From code

The Ecommerce API updates a discount with PATCH /ecommerce/api/v2/discounts/:uuid and deletes it with DELETE on the same address. The usage count is kept on the discount as usage_count.

Tip

To end an offer but keep its history, change the status instead of deleting the discount.

Note

The docs instance has no discounts. These steps follow the Ecommerce module reference in the Insites Logic Engine; no discount was changed.

Common mistakes

  • Deleting a discount a customer may still use from an email. Turn it off, and tell them it has ended.
  • Lowering the usage limit below the usage count and expecting earlier uses to be undone. They are not.
  • Changing the code of a discount you have already sent out. The old code stops working.