xDiscount is coming soon to the Shopify App Store. See it working on the live demo store.
Docs

Discounts

Discount Types

How xDiscount's five discount types work, from Percentage off to the Cart spend discount, how to set each one up, discount codes and who can get a discount.

Choosing a Type

xDiscount has five discount types, the fifth being the Cart spend discount. You pick one per discount, in the Discount type dropdown on the discount form, and the choice decides which value fields appear underneath it.

Discount typeWhat it takes offBest forExample
Percentage offA percentage of each matching lineSite-wide sales, seasonal promotions, clearing a collection“20% off every mug”
Fixed amount offA set amount off each item on the lineRound-number offers, high-ticket items“$10 off every winter jacket”
Buy X get YA percentage off a gift the shopper addsGift-with-purchase, free-sample offers“Buy a coffee maker, get a filter pack free”
Free shipping100% off the cart’s shippingRemoving the last objection at checkout, shipping promos“Free shipping on all orders containing a bike”
Cart spend discountMoney off the whole order once the cart reaches an amount you setBigger orders, “spend more, save more”“Spend $100, get 10% off your order”

By default a discount applies automatically at checkout, and shoppers enter nothing. Choose Discount code under How it applies, at the top of the form, and the discount applies only when a shopper enters its code. See Discount Codes below.

At checkout, Shopify prints the amount saved next to the discount’s label. That label is the discount’s Checkout label, or its Name when you leave the label empty. See The Checkout Label below.

xDiscount applies to one-time purchases only. Subscription orders are not discounted. The four types land on line items and on shipping.

The Cart spend discount is the one that takes money off the order itself.

What Every Discount Has in Common

Whichever type you choose, the form is the same shape. Go to Discounts and click Create discount.

At the top, under How it applies, choose Automatic discount, the default, or Discount code. A saved discount keeps its method. See Discount Codes below.

  1. Title: a Name. The name is not private: shoppers see it as the offer’s title on your product pages. An optional Checkout label sits under it, and checkout shows the name only when there is no checkout label. When another discount already has the name, ignoring capitals and extra spaces, a warning under Name says so: “Another discount is already called “Spring sale”. Shoppers and the checker show names, so a different name avoids confusion.” It is only a warning, and the discount still saves.
  2. Included products: click into the Select products and variants field, or press Browse, to open Shopify’s product picker. Choose products does the same while the list is empty. This is the set the discount attaches to. Pick a product and leave its variants alone and the discount covers every variant, now and in the future. Pick specific variants, in the picker or by unticking them in the list afterwards, and the count line says so: “1 product selected, 2 variants targeted.” Before that, you choose what the discount Applies to: Specific products, Collections or All products. For Collections, press Browse to open Shopify’s collection picker. All products needs nothing chosen. A Cart spend discount shows no choice here, because it always covers the whole order. A Collections or All products discount, a cart spend discount included, can also leave products out under Exclusions, by product or by collection. See Leaving Products Out.
  3. Discount configuration: the Discount type dropdown above, its value field, and Skip products that are out of stock. For Percentage off and Fixed amount off there is also Give a bigger discount for more items, which swaps the single value for steps. See Bigger Discounts for More Items below. Skip products that are out of stock is offered on specific products only. A Priority field shows on collection and all-products discounts, and on every discount when your store decides by My priority order. A Cart spend discount shows its steps here instead, and has no Priority. See Cart Spend Discount below.
  4. Who can get it: Everyone, the default, or Only customers who match these rules, such as customers tagged VIP. See Who Can Get It below.
  5. Discount period: an optional Start date and End date. Both are inclusive, both work on their own, and a start equal to the end is a legal one-day sale. Dates follow your store’s timezone, not yours and not the shopper’s.
  6. Conditions: optional Item quantity, Cart value and Inventory rows. Each type can be used once per discount, so three rows is the maximum.
  7. Status, in the right-hand column: Draft, Active or Archived. New discounts start as Draft.
  8. Click Save.

Save as Draft while you build it. A draft is invisible to shoppers and never applies at checkout, so you can leave it half-finished. Only Active discounts count against your plan’s active-discount limit, which is 3 on Free, 25 on Starter and unlimited on Growth and Scale.

Scheduling is not a condition. There is exactly one place to put a discount on a calendar, and that is Discount period. The Condition dropdown offers Item quantity, Cart value and Inventory, and nothing else. A discount you saved before this changed may still carry a read-only Date range (set under Discount period) row, kept so older discounts keep running as they were. Nothing can be switched to that type and a new row can never be one, so to retire it, copy its dates into Discount period, delete the row and save. See Conditions and Rules for the full picture.

The Checkout Label

Checkout label sits under Name in the Title section. It is the text shoppers see next to the discount at checkout, for example Spring sale. The form says so under the field: “What shoppers see next to the discount at checkout. Leave it empty to use the name.”

  • It takes up to 50 characters, which is as much as checkout prints. A counter under the field shows how many you have used.
  • Leave it empty and checkout shows the discount’s Name instead.
  • It works on every type: percentage, fixed amount, the gift of a Buy X get Y, and free shipping.
  • The Discount preview in the right-hand column shows the exact words checkout will print, under At checkout.

Shopify prints the amount saved beside the label, so the label never needs to repeat it. Spring sale reads better at checkout than Spring sale 15% off.

Percentage Off

Reach for it when you want the discount to scale with the price of what the shopper bought.

Field: Percentage off, entered as a number with a % suffix. The allowed range is 0 to 100 inclusive. Save anything outside it and you get “Percentage must be between 0 and 100.”

How to set one up:

1

Create the discount

Go to Discounts and click Create discount.

Name it

For example, “Autumn 20%”.

Choose your products

Click Browse under Included products and select your autumn collection’s products.

Set the type and the value

Set Discount type to Percentage off, then set Percentage off to 20.

Publish it

Set Status to Active and click Save.

Worked example. A $50 mug and an $80 kettle are both targeted at 20% off. A shopper buys 2 mugs and 1 kettle.

LinePriceQtyDiscountShopper pays
Mug$50.00220%$80.00
Kettle$80.00120%$64.00

The percentage is the same number everywhere: the admin, the storefront offer card and checkout all hold it to 0 to 100, so what a shopper is shown and what they are charged cannot drift apart. At checkout each line shows the discount’s checkout label, or its name.

Fixed Amount Off

Reach for it when you want a headline number. “$10 off” reads stronger than “13.4% off”.

Field: Amount off, a money field in your store’s currency, entered in whole currency units, so dollars rather than cents.

The one thing to know: the amount comes off each item, not each line. A $10-off discount on a line of 3 takes off $30, not $10.

How to set one up:

1

Create the discount

Go to Discounts and click Create discount.

Name it

For example, “$10 off jackets”.

Choose your products

Click Browse under Included products and select your jackets.

Set the type and the value

Set Discount type to Fixed amount off, then set Amount off to 10.

Publish it

Set Status to Active and click Save.

Worked example. $10 off a $120 jacket, and the shopper buys 2:

LinePriceQtyDiscountShopper pays
Jacket$120.002$10 off each item$220.00

Selling in more than one currency? You enter the amount in your store’s currency, and xDiscount converts it to the shopper’s currency at checkout using Shopify’s own exchange rate, rounded to that currency’s decimal places, so yen and won come out as whole numbers. The storefront offer card has no exchange rate to work with, so whenever the shopper’s cart is in a different currency from your store’s, it shows your figure with your currency code appended, for example “10 USD off”, rather than dressing your number up in the shopper’s symbol. When the cart is in your own currency the card formats it normally.

No rate means no discount

If Shopify does not hand the checkout a usable exchange rate, the fixed-amount discount simply does not apply for that order, rather than applying the wrong number. Percentage discounts are unaffected by this, because a percentage needs no conversion.

Bigger Discounts for More Items

Reach for it when you want “buy more, save more”: 10% off from 2 items, 15% off from 3.

It works with Percentage off and Fixed amount off. Under Discount configuration, tick Give a bigger discount for more items. The single value field is replaced by steps, one row each: From a number of items, and the % off (or the amount off, in your store’s currency) from that number on.

How to set one up:

  1. Go to Discounts and click Create discount, then name it “Buy more, save more”
  2. Click Choose products and select your mugs and kettles
  3. Set Discount type to Percentage off
  4. Tick Give a bigger discount for more items. Two rows appear, from 2 items and from 3 items
  5. Enter 10 on the first row and 15 on the second
  6. Set Status to Active and click Save

Add step adds a row, up to five. The bin on a row removes it, down to two. To go back to one value for every item, untick the box.

How the items are counted. Under the steps, How items count toward the steps gives three choices:

ChoiceWhat counts toward a step
All items together, where every discount startsEvery item this discount covers, across its products and variants. One mug and one kettle under the same discount count as 2.
Per productOnly items of the same product. Its sizes and colours add up, and other products count on their own. 2 blue mugs and 1 red mug count as 3, and a kettle beside them does not add to them.
Per variantOnly the same variant, as Shopify’s own volume pricing counts. 2 blue mugs and 1 red mug count as 2 and 1.

Below the first step, no discount applies, whatever the choice. In every choice:

  • Only the products and variants this discount covers count. Other products in the cart do not.
  • Gift items of a Buy X get Y do not count, and neither do variants skipped as out of stock or by an Inventory condition.
  • This is not what the Item quantity condition counts. That condition counts every item in the cart, of any product. See Conditions and Rules.

Which step applies. With All items together, the highest step the cart reaches applies to every item of the discount’s products in the cart. With Per product or Per variant, each product or variant reaches its own step, so 3 blue mugs can get 15% while 1 red mug beside them pays full price. Below the first step, nothing applies: with steps from 2 items, a shopper buying 1 pays full price.

Worked example. From 2 items 10% off, from 3 items 15% off, on a $50 mug and an $80 kettle.

CartItems countedStep reachedShopper pays
1 mug1None$50.00
1 mug, 1 kettle210% off$45.00 + $72.00 = $117.00
2 mugs, 1 kettle315% off$85.00 + $68.00 = $153.00

With Fixed amount off, each step’s amount comes off each item, exactly as a single amount does.

What the form checks. Saving is refused until the steps make sense, with the message under the box to fix:

MessageWhat to do
Each step needs more items than the step above it.List the steps from the fewest items to the most
Each step needs a bigger discount than the step above it.More items must always save more
Use a whole number of items, 1 or more.Items are counted whole
Use a percentage above 0 and no more than 100.A step worth nothing does nothing
Use an amount above 0.The same, for a fixed amount

Where you see it. The Discount preview lists every step under how they count, for example By quantity, per variant and From 2 items: 10% off. The Discounts list describes the whole range, for example 10% to 15% off by quantity, and never shows the first step on its own as if it were the discount.

Buy X Get Y

This is the type with the most moving parts, so read this section before you build one.

What it actually is: a percentage off a gift the shopper has added to the cart. A Shopify discount function cannot put a product into a cart by itself, so xDiscount does not “add a free item”. The storefront offer card gives the shopper a button that adds the gift, and the discount then takes the configured percentage off it.

Three things must all be true, or nothing happens:

RequirementWhyWhere you set it
A trigger product is in the cartThe trigger line is the proof of purchase. Only products you selected under Included products can trigger the offerIncluded products → Browse
At least one gift product is configuredWithout one there is nothing for the shopper to claimChoose gift products
The storefront offer card is on your product templateIt is what puts the gift in the cartSettings → Storefront features → Add to theme

The form says so itself: “Buy X get Y needs the storefront offer card installed on your theme. A discount cannot add an item to the cart on its own, so the card is what puts the gift there.” The card is included on every plan, Free included, so this is a setup step rather than an upgrade.

The fields

  • Percentage off the gift, from 0 to 100. Enter 100 for a genuinely free gift, and 50 makes it half price.
  • Number of gift items, minimum 1. This is the cap on discounted gift units across the whole cart, and it is also the quantity the gift button adds in a single click.
  • Gift products, the same control as Included products: click into the Select gift products and variants field or press Browse. Choose gift products does the same while there are none. Until you do, the form warns: “No gift chosen yet. Shoppers cannot claim this offer until you pick one.” Once chosen it counts them, “2 gift products selected.”, and lists each gift with its photo, its name and the variants the shopper may choose from. Untick a variant to keep it out of the shopper’s choice, and use the bin on a row to drop that gift, or Remove all to start over.
  • Which variants a gift offers is chosen in the same picker as the discount’s products. Tick a product whole and shoppers choose any of its variants in the gift window on the product page. Open the product and tick specific variants to limit the choice to those. The form says what each gift offers, All 4 variants, including any added later or 2 of 4 variants, and checkout only ever discounts a gift variant you allowed, whatever a shopper’s browser claims. Products another active or draft discount for the same buyers covers or gives away are not offered, one discount per product for each kind of buyer in both directions, but a discount’s own products are: buy two of this, get one of this is allowed and common.

How to set one up:

1

Create the discount

Go to Discounts, click Create discount, and name it “Free filters with a coffee maker”.

Choose the trigger product

Click Browse under Included products and select the Coffee Maker. This is the X.

Set the type

Set Discount type to Buy X get Y.

Set the gift value

Set Percentage off the gift to 100 and Number of gift items to 1.

Choose the gift

Press Browse under Gift products and select the Filter Pack. This is the Y.

Publish it

Set Status to Active and click Save.

Make sure the card is on your theme

If you have not already, go to Settings, then Storefront features, and click Add to theme on the offer card.

Worked example, end to end. The shopper opens the Coffee Maker page. The offer card shows a tile with the discount’s name and Free gift on the right, and under it a Choose your free gift button. They click it, a window lists the Filter Pack with an Add button, they click Add, and one Filter Pack lands in the cart marked as a gift. At checkout:

LinePriceQtyDiscountShopper pays
Coffee Maker$180.001none$180.00
Filter Pack (gift)$14.001100% off 1 unit$0.00

Caps, and what the shopper cannot do

  • Number of gift items is counted across the entire cart, not per line. Set it to 1 and a shopper who raises the gift line to 5 gets one unit discounted and pays for the other four.
  • If the number is missing or unusable, the cap is treated as 1, never as unlimited.
  • The gift is only discounted if it is one of the products you listed under Gift products for that discount. Any other line marked as a gift is ignored.
  • A line marked as a gift never counts as the trigger, so a shopper cannot claim a gift without buying the trigger product.

The gift products themselves need no setup. They do not have to be selected under Included products, and they do not get an offer card of their own. The gift picker only appears on the pages of the trigger products.

Two offers, one gift

Two Buy X get Y discounts don’t normally share a gift: the gift picker doesn’t offer a product that another live or draft discount already uses. A gift only ever counts against a discount that lists it, so two offers with different gift lists do not collide. An offer for Retail shoppers only and one for B2B buyers only may share a gift: each buyer only ever gets their own.

If two do share a gift, for example one saved before this rule, and the same cart triggers both, the one with the lower priority number gives that gift first, and once it has given all its gift items the other one gives the next.

On a discount for specific products, the form shows that priority number only when your store decides by My priority order.

Adding the gift automatically

Tick Add the gift to the cart automatically and shoppers no longer have to press a button to get the gift: the offer card says “Your free gift is added to your cart automatically” instead of showing the gift picker. Leave it unticked and shoppers pick their gift on the offer card and press Add. The form says what it does: “Adds the gift as soon as the cart qualifies and takes it out if the cart stops qualifying. A shopper who removes it does not get it back. Works only for a free gift, when the discount has no condition, a minimum quantity or a minimum cart value. With any other condition, shoppers pick the gift on the offer card.”

  • It is offered only when Percentage off the gift is 100, on any Applies to: specific products, collections or all products. A gift the shopper would pay for is never put in a cart without them asking.
  • On a discount for specific products, the gift goes in once one of those products is in the cart: “buy this board, the bag is added”. On collections or all products, once an item they cover is.
  • The cart must also meet the discount’s condition, when it has one the storefront can check exactly as checkout does: a minimum quantity (the cart’s items, gifts left out) or a minimum cart value. With no condition, the product alone is enough. Any other condition keeps the gift button on the offer card instead.
  • The gift added is the default variant you picked. A gift that is out of stock is skipped, and nothing is added while the discount is outside its dates or not active.
  • If the shopper takes the gift out, it stays out of that cart.
  • It works through xDiscount’s cart progress bar, an app embed that Shopify keeps switched off until you turn it on. Go to Settings, then Storefront features, click Turn on on the Cart progress bar and automatic gift card, then click Save in the theme editor.

If you lower the percentage after ticking it, saving is refused with the reason, for example “The gift can be added to the cart automatically only when it is free. Set the percentage off the gift to 100, or turn this off.”

Combining with item discounts

Combine with item discounts is ticked on every gift offer, including the ones saved before it existed. The products that earn the gift keep their own item discounts, and the gift is discounted as well. The form says what each side does: “On: the products that earn the gift keep their own item discounts. Off: checkout gives either the gift or those item discounts, whichever saves the shopper more.”

Untick it when a shopper should get the gift or the item discounts, but not both. Checkout then adds up what the item discounts would take off the products that earn the gift and off the gift itself. It compares that with what the gift takes off, and gives the bigger saving. A tie goes to the gift.

For example, a Special wax earns a free plain wax ($23.70), and the shopper also gets 30% off everything:

CartTickedUnticked
A Special wax ($47.45) and the plain wax as the giftSpecial wax $33.22, plain wax freeSpecial wax $47.45, plain wax free. The gift saves $23.70, the 30% would save $21.34
3 Special waxes and the plain wax as the gift3 Special waxes at $33.22, plain wax free3 Special waxes at $33.22, plain wax $16.59. The 30% saves $49.80, more than the gift
  • Every item that earns the gift counts, so a bigger cart can tip the choice to the item discounts.
  • On the product page, the offer card shows no discounted price for a product that earns such a gift, because its price changes once the shopper adds the gift. Other products keep theirs.
  • A Discount code has no such box. A code never combines with your automatic discounts: Shopify applies whichever saves the shopper more. See When a Code and an Automatic Discount Meet.
  • If the gift is added automatically and checkout keeps the item discounts instead, the gift is not free, so the cart progress bar takes it out again and leaves it out of that cart.

Common ways it goes wrong

SymptomCauseFix
No gift picker on the product pageThe offer card is not on your themeSettings → Storefront features → Add to theme
The offer card in Settings shows Not on your planThe card is on every plan, so this only happens when your subscription is on a plan the app does not recogniseClick Refresh plan under Plans and billing, and tell us if the badge stays
Save is refused with “Choose at least one gift product…”Status is Active with no gift chosenAdd a gift, or set the status back to Draft
“One of your gifts has no variant. Remove it and pick it again.”The stored gift is missing the variant the cart needsClick Clear, then pick the gift again in the picker
Gift added, but charged in fullThe trigger product is not in the cart, or the discount is outside its Discount period, or a condition is not metCheck Included products, Discount period and Conditions on the discount

Free Shipping

Reach for it when shipping cost is what is stopping the sale.

Fields: none. Choosing Free shipping replaces the value field with a single line: “Shipping is free when this discount applies.”

How to set one up:

1

Create the discount

Go to Discounts, click Create discount, and name it “Free shipping on bikes”.

Choose your products

Click Browse under Included products and select the products that should unlock it.

Set the type

Set Discount type to Free shipping.

Add a condition if you want one

Open Conditions, click Add condition, choose Cart value and set Minimum cart value to 75.

Publish it

Set Status to Active and click Save.

How it behaves at checkout. If any line in the cart carries an eligible free-shipping discount, shipping goes to 100% off, one discount per delivery group the cart has, so a split shipment is free on every part of it. It is a shipping discount rather than a product discount, so it can sit alongside a percentage or fixed-amount discount on the same order.

Worked example. A $75 minimum-cart-value free-shipping discount on bikes: a shopper with a $90 bike sees shipping drop to $0.00, and a shopper with a $60 bike pays the normal rate.

Carts with no delivery at all, meaning digital-only orders and local pickup, have no shipping to discount, so a free-shipping discount does nothing there. That is expected, not a failure.

Cart Spend Discount

Reach for it when you want bigger orders: “Spend $100, get 10% off your order”, and 15% off from $200.

What it is: money off the whole order once the cart reaches an amount you set. It is the one type that discounts the order rather than each item, so it has no product list and always covers every product. The form says so where Applies to would be: “A cart spend discount covers the whole order, so it applies to all products.”

The fields

  • Discount on the order: Percentage off the order, or Fixed amount off the order in your store’s currency.
  • The steps, one row each: Spend at least an amount, and the Discount it unlocks. One step is a complete discount. Add step adds a row, up to five, and the bin on a row removes it, down to one.
  • Also discount items that already have a discount, off by default. While it is off, items that another xDiscount discount already lowers are left out of this one, so no item gets two discounts. Tick it and this discount takes money off those items too.

How to set one up:

1

Create the discount

Go to Discounts, click Create discount, and name it “Spend more, save more”.

Set the type

Set Discount type to Cart spend discount.

Choose how it takes money off

Leave Discount on the order on Percentage off the order.

Set the first step

On the first row, enter 100 under Spend at least and 10 under Discount.

Add a second step

Click Add step, then enter 200 and 15.

Publish it

Set Status to Active and click Save.

Which step applies. The highest step the cart reaches applies to the whole order. Below the first step, nothing applies. Gift items of a Buy X get Y do not count toward the amount.

The amount is counted after item discounts. Checkout measures the cart’s subtotal once the discounts on items are taken off, the same subtotal the shopper sees in the cart. When an item discount keeps a cart just under a step, Shopify may leave that item discount out and give the cart spend discount instead, because it always applies the combination that saves the shopper the most.

Worked example. From $100, 10% off. From $200, 15% off. Also discount items that already have a discount is off.

CartStep reachedOff the order
$80 of productsNone$0.00
$120 of products, none with a discount10%$12.00
$250 of products, none with a discount15%$37.50
$250 of products, including a $50 mug that already has its own discount15%15% of the other $200, so $30.00

One active at a time. Your store can have one Active cart spend discount on any given day. Put more steps on it rather than making a second one. You can schedule the next one ahead: a second one can be Active too when its Discount period shares no day with the first one’s. Setting a second one to Active on some of the same days is refused, and the form says so under Status before you save: “Only one cart spend discount can be active at a time. “Spend more, save more” is already active on some of the same days. Change the dates so they do not overlap, or archive it or set it to Draft first.” The same goes for Activate discount, Set as active on the Discounts list and a connected assistant. Any number can wait as Draft or Archived, and the live one can be edited and saved as often as you like. A cart spend discount has no Priority field, because with only one live there is nothing for it to decide.

Conditions and dates. Item quantity and Cart value conditions work as they do on any discount, and so do Start date and End date. Inventory and Skip products that are out of stock are not offered, because the discount is not about one product.

Selling in more than one currency? You enter every amount in your store’s currency. A fixed amount off is converted to the shopper’s currency at checkout, exactly as for Fixed amount off.

What the form checks. Saving is refused until the steps make sense, with the message under the box to fix:

MessageWhat to do
Each step needs a higher amount than the step above it.List the steps from the smallest amount to the largest
Each step needs a bigger discount than the step above it.A bigger order must always save more
Use a percentage above 0 and no more than 100.A step worth nothing does nothing
Use at most 2 decimals, like 10.50.Checkout charges whole cents
A cart spend discount can have at most 5 steps.Remove a step

Where you see it. The Discounts list describes it by its range and its first amount, for example 10% to 15% off orders from $100.00, and its Products column reads Whole order. The Discount preview lists each step, for example From $100.00: 10% off the order, and whether items that already have a discount are included.

Discount Codes

A discount code applies only when a shopper enters its code at checkout. Every type except Buy X get Y can be a code, on specific products, on collections or on all products.

One Code

1

Choose Discount code

At the top of the discount form, under How it applies, choose Discount code. You choose this once. A saved discount keeps its method, so to use the other one, create a new discount.

Set the code

Type the Code, for example SPRING15, or press Generate for a random one. Use letters, digits, dashes and underscores, up to 255 characters. Shopify refuses a code another discount in your store already uses, and the save tells you so in Shopify’s own words.

Set a usage limit if you want one

If you want a cap, set the Usage limit: how many times the discount can be used in total, across all of its codes. Leave it empty for no limit.

Limit it to one use per customer if you want

Tick Limit to one use per customer if each customer may use it once.

Save

Fill in the rest of the form as for any discount, and click Save.

The discount also appears in Shopify’s own Discounts list, under its name, with its code. Its dates, status and limits follow what you set in xDiscount, so change them in xDiscount rather than in Shopify.

Many Codes

Once the discount code is saved, Create more codes, under its code, makes extra codes for it, for example one per customer in an email campaign:

  • Number of codes: from 1 to 100,000. A discount can have at most 100,000 extra codes in all.
  • Prefix: optional, up to 20 letters, digits, dashes or underscores at the start of every code, such as SPRING-.
  • Random characters: from 6 to 16 after the prefix. They are capital letters and digits that are easy to tell apart, so there is no 0, O, 1, I or L.

Press Create codes. The codes are made in the background, a few thousand at a time, and the list under the button shows each request with how many codes were created and how many failed. A code fails when your store already has it. It is left out and not counted. Every code works on its own, and the Usage limit counts all of them together.

Downloading the Codes

Download codes gives you a CSV file with one column, Code: the main code first, then every code that was created. Codes that failed are not in it.

Limits, and Where Codes Work

  • At most 100,000 extra codes per discount in xDiscount. Shopify allows at most 20,000,000 codes in one store, across every app and Shopify’s own discounts, and no app can raise that.
  • Codes work on Shopify POS when the staff member has the Apply discount codes permission. They do not work on exchanges.
  • A discount code is not shown on the product page. A code is something you hand out, and the offer card cannot know whether a shopper has it. Your automatic discounts still show there.
  • A discount code does not skip out-of-stock products, takes no Inventory condition and no Priority, and cannot add a gift to the cart automatically. The form hides those for a discount code.
  • A discount code cannot be a Buy X get Y. The gift is free only when the shopper adds it from the offer on the product page, and that offer never shows a code. Use an automatic discount for a gift.
  • A discount code on specific products can name a few hundred products before it reaches Shopify’s 10,000-byte limit for discount functions. For more, use collections.

When a Code and an Automatic Discount Meet

When a shopper enters a code, Shopify compares it with your automatic discounts on the whole cart and applies whichever saves the shopper more. It does not mix them item by item. A discount code on items or for free shipping does not combine with any other discount.

A cart spend code is different: it adds to your automatic discounts on items and to free shipping, as an automatic cart spend discount does. Unless you tick Also discount items that already have a discount, it leaves out the items those discounts already reduce.

Who Can Get It

Every discount has a Who can get it section, between Discount configuration and Discount period. It works on every type, automatic or code.

Retail Shoppers or B2B Buyers

The section starts with Retail shoppers or B2B buyers, for stores that sell to companies through B2B on Shopify:

  • Retail shoppers only: shoppers buying for themselves. B2B buyers, who buy for a company at their own prices, do not get it. A new discount starts here, so a retail sale never lands on top of a wholesale price.
  • B2B buyers only: only buyers who are buying for a company in your store’s B2B.
  • Retail shoppers and B2B buyers: every buyer. A B2B buyer gets it on top of their company’s prices. Every discount made before this choice existed is for both, and keeps working as it did.

A different offer for each kind of buyer. A product belongs to one discount for each kind of buyer, so one discount for Retail shoppers only and another for B2B buyers only can cover the same products, each with its own value, gift, conditions and Combine with item discounts. Each buyer only ever sees and gets their own: the offer card, the badges and the cart bar show a shopper only the offers they can get. For example, the same snowboard can offer retail shoppers Buy a Snowboard, Get Wax Free while your companies get 30% off, with no gift offered to them. Two discounts that reach the same buyers, or a discount for both beside any other, still can’t share a product.

B2B buyers get a discount only where your store’s B2B discounts are turned on in Shopify. xDiscount cannot read that setting, so try a company buyer in the Discount checker with Check as: A B2B buyer. In Shopify’s Discounts list, leave the xDiscount discounts open to all customers and choose who gets each offer here. If one of them is limited to some markets or customers in Shopify, Home says so.

With B2B buyers only, two more choices narrow which companies get it:

  • Which companies: Every company, the default, or Only these companies, picked from your store’s companies in Shopify. A buyer gets it only when buying for one of them, at any of its locations. Click Browse to open Choose companies, search by name, tick up to 50 companies and click Done. The chosen companies are listed under the field, each with a button to remove it.
  • Customer for at least: only companies that have been your customers for at least the number of days you enter, by the Customer since date on the company in Shopify. Both together mean the chosen companies that have been customers that long.

xDiscount reads your companies from Shopify when you save, and again every day, so a company that reaches the number of days, or a location added to a chosen company, gets the offer by the next day. A discount can reach up to 50 chosen companies and up to 100 company locations in all. Free shipping cannot be kept for chosen companies yet.

Access to your companies. xDiscount asks for access to your companies in Shopify when you install it. If your store had xDiscount before an update added that access, Shopify asks you to approve it the next time you open xDiscount. Until you do, a notice under Which companies says “xDiscount has no access to your companies in Shopify yet” and “xDiscount needs that access to keep this discount for chosen companies, or for companies by how long they have been customers. Open xDiscount again from your Shopify admin and approve the access Shopify asks for. Until then, every B2B buyer can get this discount.” Only these companies and Customer for at least stay greyed out until you approve it.

Where It Applies

Next comes Where it applies, for stores that also sell in person with Shopify POS:

  • Online store and in store: orders in your online store and in store on Shopify POS. Every discount starts here, and every discount made before this choice existed keeps working as it did.
  • Online store only: only orders in your online store. A sale for your website does not reach the register.
  • In store only: only orders in store on Shopify POS. Your product pages, badges and cart progress bar never show it.

In store, Shopify applies automatic discounts only at locations with POS Pro, and discount codes only for staff allowed to apply them. Gift offers need your product page to add the gift, so they do not apply in store yet.

Everyone, or Customers Who Match Rules

Then:

  • Everyone, the default: every shopper of the kind chosen above, logged in or not.
  • Only customers who match these rules: turn on one or more of the rules below. Every rule you turn on must hold.
RuleWho gets the discount
Retail shoppers or B2B buyersThe choice above: retail shoppers only, B2B buyers only, or both. It holds together with every rule below, so a discount can be for B2B buyers tagged Gold.
Which companiesWith B2B buyers only: every company, or only the companies you choose. A buyer gets it when buying for one of them.
Customer for at leastWith B2B buyers only: companies that have been your customers, by their Customer since date in Shopify, for at least this many days.
Where it appliesThe choice above: online store and in store, online store only, or in store only. It holds together with every rule below, so a discount can be for VIP customers in store.
Logged-in customers onlyShoppers signed in to a customer account in your store. Guests do not.
Customers taggedLogged-in customers with at least one of the tags you add in Customer tags, as the tags are set on the customer in Shopify. Up to 10 tags of up to 40 characters each. Capitals do not matter, so VIP and vip are the same tag.
First order onlyLogged-in customers who have never placed an order in your store.
Lifetime spend at leastLogged-in customers who have spent at least the amount you enter in your store, over all their orders, in your store’s currency. It cannot be combined with First order only, since a customer on their first order has spent nothing yet. A shopper browsing your store in another currency does not see the offer on the product page, the badges or the cart progress bar, because the storefront cannot convert their spend, but checkout still gives it to them.
CountriesShoppers browsing your store in one of the countries you choose, the country your store’s country selector shows. Up to 50. Click Browse to open Choose countries, search by name or two-letter code, tick the countries and click Done. Shopify’s own list is offered, grouped by continent. An offer only reaches shoppers in a country one of your markets sells to, so the window lists the countries your store sells to first, and the form warns you about any other. To make a discount for Italy, first add Italy to a market in Shopify, under Settings, then Markets.

Skip items already marked down sits under the choice and works whoever gets the discount, Everyone included. It leaves out items whose compare-at price is above their price, so an item already on sale does not get this discount on top.

A tagged customer, one on their first order, or one with enough lifetime spend, gets the discount only once logged in to their account. Checkout does not trust an email address typed at checkout to say who someone is.

Example: 15% Off for Customers Tagged VIP

1

Tag your VIP customers in Shopify

Open Customers, open a customer, and add VIP under Tags.

Create the discount

In xDiscount, create a Percentage off discount with Percentage off set to 15, on the products, collections or all products you want.

Choose who can get it

Under Who can get it, choose Only customers who match these rules and turn on Customers tagged. Type VIP in Customer tags and press Add.

Publish it

Set Status to Active and click Save.

A logged-in customer tagged VIP gets 15% off at checkout. A guest, or a customer without the tag, pays the full price, and the product page, the badges and the cart progress bar do not show them the offer. The discounts list and the Discount preview say who can get it in one line, here “VIP customers only”.

Limits

  • All your live discounts together can ask about at most 100 customer tags. A save that would pass that is refused: “Your live discounts would use 104 customer tags between them, and checkout can check at most 100. Use fewer tags, or reuse the tags your other live discounts already use.”
  • When the rules hold for nobody, nobody gets the discount. Checkout never guesses: a rule it cannot read keeps the discount out rather than giving it to everyone.

When Several Discounts Match

  • Only one discount applies per item, and you choose which. Under Settings, then Overlapping discounts: Biggest discount wins, the default, gives the item the discount that takes the most off it. The product’s own discount first tries a discount set on the product, then collection discounts, then all-products discounts, with priority deciding at the same level. My priority order gives it the discount with the lowest priority number. If a discount’s conditions are not met, the next one gets its chance. See Priority, Which Discount Wins for a worked example.
  • A discount code is judged by Shopify. When a shopper enters a code, Shopify compares it with your automatic discounts on the whole cart and applies whichever saves the shopper more. It does not mix them item by item. A cart spend code is the exception: it adds to your automatic discounts on items and to free shipping.
  • A product belongs to one discount for each kind of buyer. The product and gift pickers don’t offer a product that another live or draft discount for the same buyers already uses, as a product or as a gift, so your discounts normally never compete for the same item. A discount for Retail shoppers only and one for B2B buyers only may share products, as they never meet. See Who Can Get It. Archive a discount to free its products. xDiscount also refuses the rest on save, however a discount is saved: a product another discount for the same buyers holds, an archived discount brought back after another discount took one of its products, and a change to Who can get it that would make two discounts on one product reach the same buyers: “A product can belong to one discount for retail shoppers and one for B2B buyers, and some of these already belong to “Spring sale”, which reaches the same buyers. Archive that discount, remove the products from it, or make one of the two for retail shoppers only and the other for B2B buyers only.”
  • Free shipping is judged separately, so one order can get a percentage off one product and free shipping from another product’s discount. Under Biggest discount wins, a free shipping or Buy X get Y offer never takes an item’s place, so the item still gets its biggest percentage or fixed-amount discount.
  • A cart spend discount is judged separately too, on the whole order, after the discounts on items. By default it leaves out items that already have one of your discounts, so it never gives an item a second discount. Only one cart spend discount can be active at a time.
  • If two discounts on specific products do reach the same item, after an archived discount is brought back once its products went to another discount, or with one saved before the one-discount rule, only one of them applies to that item. Discounts made in the form carry priority 10. To settle it, archive the discount you don’t want on that product, or remove the product from it. Your Overlapping discounts choice picks which one applies, and a tie goes to the lower priority number. Under The product’s own discount first or My priority order, a Free shipping or Buy X get Y discount that wins an item this way leaves it without a percentage or fixed-amount discount.

What Happens When Something Is Off

xDiscount is deliberately cautious at checkout: anything it cannot judge with confidence results in no discount, never a guessed one. A date it cannot read, a value it cannot parse, an exchange rate it cannot trust, each of these means the discount quietly does not apply rather than applying the wrong amount. If a discount is not showing up at checkout, that caution is usually the reason, and the Sync state on the Discounts page is the first place to look. See Managing Discounts for what each sync state means.