Promo Codes

Admin

Use this page to create discount codes that customers type at online checkout or give to the cashier at the register.

Quick steps

1. Go to Storefront in the admin and click the Promo Codes card.
2. Click New Promo Code.
3. Type the Promo Code (for example SAVE20), pick the Discount Type (Percentage (%) or Fixed Amount ($)) and enter the Discount Value.
4. Optionally set a Minimum Order Amount, Max Uses, and Start Date / End Date.
5. Click Create Promo Code.

Customers enter the code in Have a promo code? on the cart page or Promo Code at checkout. At the register, open the Discount screen, type it under Promo code and tap Apply code.

Common questions

A code won't work. The customer sees why — for example expired, usage limit reached, or order below the minimum. Check the code's Status in the list.

Does a code discount everything in the cart? Everything except products ticked Exclude from automatic promotions. The minimum order is still judged on the whole order.

Can a customer use two codes? No. One promo code per order.

How do I stop a code without deleting it? Click Edit, untick Active, and click Update Promo Code.

Does it work offline at the register? No. The register needs a connection to check a code.

---

More detail: using a code at the register

Using a code at the register

On the register, open the Discount screen, type the code under Promo code and tap Apply code. The Discount screen then shows the code and the amount taken off (for example "SAVE10 applied (−$5.00)"); tap Remove to take it off. The same rules apply as online. The register needs a connection to check a code — offline it says "Promo codes need a connection to the server. Try again when back online."

If your store runs promo games, the same box also accepts a promo game prize code.

More detail: the promo code list

Accessing Promo Codes

1. Log in to the Admin Panel as an admin.
2. Go to your Storefront dashboard and click the Promo Codes card. You can also search for "Promo Codes" in the admin search.

The list shows each code with these columns:

Column	What it shows
Code	The code customers type.
Discount	For example "10% off" or "$5.00 off".
Min Order	The minimum order amount, or "None".
Usage	Times used, and the limit if there is one (e.g. 12 / 50).
Status	Active, Scheduled (start date is in the future), Expired (end date has passed), Maxed Out (usage limit reached), or Inactive (turned off).
Dates	The start and end dates, or "No date limits".
Actions	Edit or Delete.

Use Export CSV to download all your codes.

More detail: every field when creating a code

Creating a Promo Code

1. Click New Promo Code.
2. Fill in the form:

Field	Required	Description
Promo Code	Yes	The code customers enter, e.g. SAVE20. It's saved in capitals, and customers can type it in any case. Each code must be unique in your store.
Discount Type	Yes	Percentage (%) or Fixed Amount ($).
Discount Value	Yes	Enter 10 for 10% off, or the dollar amount for a fixed discount. A percentage can't be more than 100.
Minimum Order Amount	No	The order must reach this amount for the code to work. Leave it blank or at 0 for no minimum.
Max Uses	No	The total number of times the code can be used, across all customers. Leave it blank for unlimited.
Active	—	Uncheck to turn the code off without deleting it.
Start Date (Optional)	No	When the code starts working. Leave it blank to start right away.
End Date (Optional)	No	When the code stops working. Leave it blank for no expiry.

3. Click Create Promo Code.

Keep codes simple

Short codes like WELCOME10 or SAVE20 are easy to type on a phone.

More detail: how customers use codes, and error messages

How Customers Use Promo Codes

1. The customer adds items to their cart on your storefront.
2. They enter the code in the Have a promo code? box on the cart page, or in the Promo Code section at checkout, and click Apply.
3. If the code is valid, the discount is shown and taken off the order.

How the discount is worked out:

• It's worked out from the items the code is allowed to discount: everything in the cart except products ticked Exclude from automatic promotions.
• A fixed-amount discount is never more than that eligible amount.
• Minimum Order Amount is judged on the whole order, excluded products included. A $60 order still meets a $50 minimum even when $40 of it is excluded bundles — only the amount being discounted shrinks.
• One promo code can be used per order. It applies on top of any automatic storefront pricing.

If the code can't be used, the customer sees one of these messages:

Message	Why
Invalid promo code	No code with that name exists.
This promo code has expired	The end date has passed.
This promo code has reached its usage limit	Max Uses has been reached.
Minimum order of $X required	The order is below the minimum.
This promo code doesn't apply to the items in your cart	Every product in the cart is excluded from automatic promotions, so there is nothing the code may discount.
This promo code is not yet active	The start date hasn't arrived.
This promo code is not valid	The code has been turned off.
Too many attempts. Please try again later.	Too many codes were tried in a short time (more than 10 in 5 minutes).

More detail: tracking usage, editing and deleting

Tracking Usage

The Usage column counts each online order and each register sale completed with the code. When a code has a Max Uses limit, it stops working as soon as that limit is reached. Its status then changes to Maxed Out.

Each online order placed with a code keeps a record of the code and the discount amount in its notes.

Editing, Turning Off, and Deleting Codes

• Edit: Click Edit to change the discount, minimum order, max uses, dates, or the Active checkbox. Then click Update Promo Code.
• Turn off: Edit the code and uncheck Active. Check it again later to turn it back on.
• Delete: Click Delete to remove the code from your list. Past orders keep their discount.

More detail: best practices, and promo codes vs. sale campaigns

Best Practices

Welcome codes

Create a WELCOME10 code and promote it in your storefront's hero section or announcement bar.

Seasonal promotions

Give codes start and end dates for holidays or events. For example, BLACKFRIDAY could run for the last week of November.

Win-back codes

Create a code like COMEBACK15 and send it to customers who haven't ordered in a while.

Limited-use codes

Set Max Uses to create urgency, e.g. "First 50 customers get 20% off with code FLASH20".

Promo Codes vs. Sale Campaigns

	Promo Codes	Sale Campaigns
How it's applied	The customer enters a code	Automatically
Where it works	Storefront and POS register	POS register and storefront
What it discounts	The order, apart from products excluded from automatic promotions	Specific products or categories
Best for	Marketing, social media and email campaigns	Store-wide or category sales

---

What's Next?

• Sale Campaigns — Automatic discounts that apply without a code.
• Abandoned Cart Recovery — Re-engage customers who left items in their cart.
• Storefront — Storefront setup and configuration.