Sales and discount codes

The free plugin gives you a shop-wide sale and full discount codes. Automatic discounts, which fire on quantity or order value without a code, are part of Bang! Cart Pro.

Everything here lives on the Discounts tab.

The rule that governs all of them

One discount per order, and the customer gets the biggest one. Discounts do not add up. If a basket qualifies for more than one, whichever saves the most is the one that applies, and you never have to remember to switch one off before switching another on.

So a 20% sale running alongside a "buy six, save £3" rule gives the shopper whichever saves them more on that basket - never both.

Free delivery is the exception, because it is postage rather than goods. A free-delivery code still applies alongside whichever discount won.

The shop-wide sale

A percentage off everything, for as long as you leave it on. Set the percentage, write a banner message if you want one, choose its text colour, and switch it on.

The Discounts tab: the One discount per order explainer with the stacking option, and the Shop-wide discount card with its sale switch
One discount per order is the rule; the stacking tick is the one exception, off by default.

The sale is applied as a price, not as a lump taken off at the end, so a £5.50 item at 20% off is charged as £4.40 and reads that way everywhere, including on Stripe's page. The [bangcart_price] shortcode shows the sale price with the old one struck through beside it, unless you ask it not to.

Use [bangcart_sale_banner] anywhere in your template to announce it. The admin's copy button hands out the older name [sale_banner]; both do the same thing. It renders nothing while the sale is off, so it can live there permanently.

Discount codes

Codes a customer types into the basket. Each row on the Coupon codes table gives you:

The basket's "Discount code?" field appears only while you have a live code - one that is active, not past its expiry and not used up. With none, the field is simply not drawn: a prompt for a code that does not exist sends shoppers off to hunt for one, and some abandon the basket doing it. There is no setting; it follows this table on its own. And because the field's presence is baked into any cached copy of a page, saving the code that makes it appear - or retiring the last one - shows you a dialog saying to clear your page or performance cache, that one time only.

FieldWhat it does
CodeWhat the customer types. Letters, numbers, hyphens and underscores; stored in capitals.
TypePercent off, Amount off, or Free delivery.
ValueThe percentage or the amount. Ignored for free delivery.
Min spendOnly valid on orders at or above this. Measured on the goods at list price.
ExpiresA date, inclusive, in your site's timezone. The code works all day on that date.
Max usesLeave it empty, or 0, for unlimited. Otherwise the code stops working once it has been used that many times.
UsedA read-only counter. You cannot edit it, and nothing you type there is honoured.
ActiveAn on/off switch, so you can pause a code without deleting it or losing its history.

There is no start date, no per-product restriction and no per-customer limit.

When a use is counted

At payment, not at checkout. An abandoned basket never burns a limited code. The count is taken under a lock, so two customers redeeming the last use of a code in the same second cannot both get through.

A code that is rejected for minimum spend is remembered and reapplied automatically if the basket grows past the threshold, so a customer does not have to type it again.

When a code loses

If a customer types a perfectly valid code but one of your own discounts saves them more, the basket says Better discount applied and gives them the bigger saving. The code is not rejected and nothing is hidden. They simply get the better deal.

If there is nothing in the basket a code could apply to, it says Not valid on this order instead.

The Coupon codes table: four codes with type, value, minimum spend, expiry, use limits and an Active tick
Codes are checked on the server before any money is taken.

Letting a code stack

Since 3.2.7 there is a choice at the top of the Discounts tab: Let a discount code apply on top of an automatic discount. It is off by default.

Switch it on and a customer's code is taken off after the best automatic discount, so a code and a sale combine, which is how most shops actually work. What does not change: the automatic discounts still never stack on each other, only ever one of them applies, and the total can never fall below zero.

What is never discounted

Customer-set prices, where the buyer types the amount themselves for a deposit, a balance or a booking fee. The amount typed is the amount charged. No sale, no quantity rule and no code touches it.

A code still applies to the rest of the basket as normal. Customer-set prices are a Pro feature.

Free delivery

Two ways to offer it, and they are different tools.

  • Free postage over a threshold, set on the shipping zone. Applies to everyone automatically, no code needed. See Postage zones and services, and note that it makes one service free rather than all of them.
  • A free-delivery code, which zeroes the postage on that order. The customer still chooses which carrier.

Because free delivery sits outside the goods contest, a 20% sale and a free-delivery code will both apply to the same order. If you do not want that, switch the code off while the sale runs.

Automatic discounts, with Pro

Bang! Cart Pro adds two kinds of discount that apply by themselves, with no code to type, and free gift offers. All three live on the Discounts tab, each in its own card. The two discounts take part in the same one-discount contest as everything above: the customer gets whichever single discount saves them most. A free gift, unless you say otherwise, comes on top.

Quantity discounts

"Buy 6 or more, £3 off." Each row has three parts:

  • Buy this many or more - the number of items that earns the discount.
  • Up to - optional. Leave it empty for "or more". Fill it in to stop the row at a quantity, for when something else takes over above it.
  • Take off - the amount taken off the order.

The count is the whole order, not each line. Three jars of chutney and three jars of jam is six items, so a "6 or more" row applies, once, and takes £3 off the order. It does not take £3 off each line.

Applies to narrows a row to certain products. With nothing ticked, every product counts. Choose Only these and tick the jars, and only the jars are counted towards that row.

Or choose All except these and tick the ones to leave out. A shop selling jars and a downloadable recipe card can leave the card out, so one jar and the card is one item, not two - and a jar added next month still counts without anyone touching the row. Downloads are marked DOWNLOAD in the list so they are easy to spot.

If an order matches more than one row, the one for the larger quantity wins. Rows you have bounded with Up to are stepped over once the order outgrows them, and a smaller open-ended row below can then apply instead. The card warns you when your rows leave a gap like that, so you find it on the Discounts tab rather than in a customer's basket.

Order value discounts

"Spend £50 or more, get 10% off." Each row is a spend and an amount to take off, as a fixed sum or a percentage. If an order clears more than one row, the highest one it clears applies.

The spend is measured on the goods at their list price. Postage is never included.

Free gift offers

"Buy the chutney and the tea towel, get a recipe card set free." Each offer has two parts:

  • When the basket has all of - the products that earn the gift. Any size or colour of them counts.
  • Free gift - the product given away. It can be anything without sizes or a price the customer sets. A download works too. Products that can't be a gift are greyed out in the list, and say why.

Once the basket has every product in the offer, the gift appears in it by itself at £0.00, marked as a free gift. The customer doesn't have to do anything to claim it, and if they take one of the products out, the gift goes too. When they have all but one, the basket names the missing product with an Add it button.

One gift per order, however many of each product they buy. The gift never counts towards a quantity discount and never adds to postage. It comes off its stock with the order, and if it sells out the offer pauses by itself - the row says so on the Discounts tab, and customers aren't promised anything you can't send.

On Stripe's payment page, the receipt, the emails and the Orders page, the gift shows as its own line, "(free gift)", at £0.00.

Give the gift on top of other discounts is on to begin with: a gift isn't money off, so the customer gets it alongside whichever discount wins. Switch it off and the gift becomes the order's one discount, worth its price - the bigger of the gift and any money off wins.

How they sit with everything else

  • Still one discount per order. A quantity discount, an order value discount, your shop-wide sale and a customer's code all compete, and the biggest saving wins. Automatic discounts never add up with each other.
  • A code can still stack on top, if you switch on Let a discount code apply on top of an automatic discount (see Letting a code stack above).
  • Customer-set prices are left out. They are never discounted, and they do not count towards earning a quantity discount. See Customer-set prices.
  • Free delivery is separate, as it is for every other discount: it applies alongside whichever discount won.

Every row has its own switch. Turn a rule off for a week and back on again without retyping it. Remove all the rows in a card and that kind of discount simply stops.

Turning things off

Everything has a switch, and nothing needs deleting to stop it. The sale has one, and every code has one. Switch a rule off and it keeps its settings, ready for next time.

If Pro is switched off, automatic discounts pause. A note on the Discounts tab explains that the rules were made with an add-on that is not active. They are kept untouched, baskets pay the list price meanwhile, and no discount is ever guessed at. An expired licence does not do this - Pro keeps working, and only updates and support stop.

Still stuck?

Write to me and it is me who answers, not a ticket queue. Tell me what you expected and what happened instead.

Ask a question

Bang! Creative Family

Bang! Plugins is part of a small UK creative group, so the plugins are made and backed by people who do this for a living.