The Discount Codes view lists all codes in your workspace. From here you create, edit, enable, disable, and archive codes.
Create a discount code
Click Create discount code to add a new code. The code is created immediately as a disabled placeholder and opens in the editor, where you configure its type, value, restrictions, and validity.Read more: How to create and share a discount code
View usage
The table shows each code’s usage count against its limit (or unlimited). Click a code to see its full configuration.
Enable or disable a code
Toggle a code’s Enabled status from the detail view. Disabled codes are rejected at checkout.
Search and filter
Search by code name, or filter by enabled status, validity dates, and usage count. The Value column filters on the type as one choice — Percentage, Fixed (per order), or Fixed (per item) — rather than on the two form controls separately.The Auto-apply column reads Automatic or Manual, and filters on the same two choices. Sort by code, value, usage count, valid-to date, or creation date.
Catalog > Discounts
Apply a code automatically
Turn Auto-apply on and the code stops depending on anyone typing it: shoppers see its discounted prices while browsing the storefront, and the discount lands on the order at checkout. In storefronts narrows which storefronts it works in.Read more: Discount Codes concept
Archive a code
Removing a code archives it. The action is Archive, from the detail view or by selecting codes in the table. The code leaves the list but still exists — find it under Settings → Archived assets to unarchive it or delete it permanently. Unarchiving fails if an active code has since taken the same string, so rename one of them first.Archiving a code does not affect orders that already used it — the code string and allocations are snapshotted on the order.Read more: Archiving and Deletion
Configure these fields when creating or editing a discount code.The four catalog fields show their selection as removable chips. Click Edit on any of them to open a dialog listing your whole catalog, so you can browse for an item instead of recalling its name.
Setting
Description
Code
The string customers enter. Letters (including accented and non-Latin characters), digits, dashes, and underscores only (1–64 characters). Case-insensitive — stored as uppercase.
Description
Optional internal notes about the code’s purpose. Not visible to customers.
Enabled
Whether the code is active. Disabled codes are rejected at checkout and cannot be applied to orders.
Who can use this code
Anyone with the code (default) — customers, staff, and integrations can all redeem it. Only staff and integrations — customers who enter the code at checkout are rejected; staff and integrations can still apply it. Internal codes are marked with a “Staff only” chip in the table.
Auto-apply
Apply the code automatically instead of waiting for someone to type it. Shoppers see discounted prices while browsing, and the discount lands on the order at checkout. Off by default.
In storefronts
Shown only when Auto-apply is on. Which storefronts the code applies itself in. Leave empty for all storefronts.
Combinable
Whether the code may discount an item alongside other combinable codes. A non-combinable code is always the only discount on the items it applies to. Codes that discount different items work side by side either way. Off by default.
Discount type
Percentage (0–100 %) or Fixed (a currency amount).
Scope
Shown only for a fixed code. Per order applies the amount once to the whole order, spread across eligible items; Per item applies it to each eligible item separately. A percentage has no scope — it is per item by nature.
Value
The discount amount — a whole percentage or a currency amount depending on the type.
Applies to
Restrict to specific purchase types: bookings, sales, subscriptions. Leave empty to apply to all.
Applies for
Shown in a Subscriptions section, which appears whenever the code can reach subscriptions — including when Applies to is left empty. First cycle only, A number of cycles (which asks for Number of cycles), or Every cycle.
Apply to listings
Restrict to specific listings. Leave empty to apply to all.
Apply to collections
Restrict to items in specific collections. Leave empty to apply to all.
Exclude listings
Carve specific listings out of the code’s scope. An excluded listing never gets the discount, even when Apply to listings or Apply to collections covers it. Leave empty for None.
Exclude collections
Carve out every item in specific collections, on the same rule. Leave empty for None.
Limit to locations
Restrict to checkouts at specific service locations. An order-level gate — the whole checkout’s location either matches or it does not. Leave empty to apply to all.
Usage limit
Maximum number of times the code can be used. Leave empty for unlimited. On an auto-apply code this reads as “the first N orders get the discount” rather than as a per-customer limit, because every matching checkout claims the code.
Offered from / Offered until
Date window when the code is redeemable. Outside this window the code is rejected.
Discount period from / Discount period until
The dates the discount covers. A booking is covered when its start falls inside the window, a sale when it is bought inside it, and a subscription cycle when it is billed inside it.
Set the Code string — pick something memorable for customers.
Choose the Discount type and enter the Value. A fixed code also asks for a Scope — per order or per item.
Add the restrictions you need: Applies to, Apply to listings, Apply to collections and Limit to locations. Name the items the code must never touch under Exclude listings and Exclude collections.
Set the two date windows, Offered from / Offered until and Discount period from / Discount period until.
Turn Auto-apply on if the code should apply itself rather than be typed, and pick the storefronts under In storefronts.
Set a Usage limit if the code should expire after a number of uses.
Toggle Enabled on when the code is ready for customers.
Discount codes reduce the price of eligible items after the base price is calculated from Price Tables. Codes can be restricted by purchase type, listing, collection, location and date windows, and can carve named listings or collections back out of whatever they cover.Read more: Discount Codes concept
Price Tables
Price Tables define the base price for a listing. Discount codes apply on top of Price Table pricing.Read more: Price Tables
Discount codes on orders
Applied codes appear on the order with their per-item allocations. Operators can add or remove codes from the order detail page.Read more: Order Line Items
This view is gated by catalog:discount, in the four operations — , , and .Owner, Admin and Manager hold every operation. Member does not hold it at all.For what each operation means and the full role matrix, see Users & Roles.
