Discounts
Targeting Products
How an xDiscount discount targets products and variants, why whole-product targeting wins, out-of-stock skipping, and the 10,000-byte product limit.
Where Targeting Lives
A discount applies to the products you choose, and a discount that applies to nothing cannot be saved.
A discount can also apply to every product in the Collections you choose, or to All products in your store. You make that choice under Applies to, at the top of the Included products section: Specific products, Collections or All products. This page is mostly about specific products. Collections and all products have their own section below.
Open the Discounts page
Click Discounts in the app’s sidebar.
Open a discount
Click Create discount, or click the name of a discount you already have.
Find the Included products section
It sits between Title and Discount configuration on the discount form.
Above the product list is a summary line, and each product carries its own line underneath it.
| Your selection | What the section shows |
|---|---|
| Nothing yet | The No products yet empty state, with a Choose products button |
| Whole products only | 3 products selected., and each product reads All 4 variants, including any added later |
| Some products narrowed | 3 products selected, 5 variants targeted., and a narrowed product reads 2 of 4 variants |
If you try to save with nothing selected, the section shows “Choose at least one product for this discount to apply to.”, the page shows the banner This discount can’t be saved yet, a toast reads “Fix the highlighted fields before saving.”, and nothing is written.
Choosing Products
xDiscount uses Shopify’s own product picker, the same one you see elsewhere in your admin. Included products is a working list, not a read-only summary. Everything on it can be changed in place.
| Control | What it does |
|---|---|
| The Select products and variants field | Click into it to open Shopify’s product picker. The same thing as Browse |
| Browse | Opens Shopify’s own product picker, pre-filled with your current selection |
| Choose products | The button inside the No products yet empty state. The same thing as Browse |
| Remove all | Empties the selection, and clears the variant narrowing with it. It appears only when products are selected |
| The delete button on a row | Removes that one product. Its accessible name is Remove plus the product’s title |
| Variants (4) | Expands a product with more than one variant. Each variant is a checkbox, with its price and stock beside it |
| Show all 30 products / Show fewer products | The list shows 24 products at a time |
Open the picker
In Included products, click into the Select products and variants field or click Browse, or Choose products if nothing is selected yet.
Pick your products
Search and tick as many products as you like. The picker is multi-select, and it opens pre-filled with what the discount already targets, so adding one product does not lose the other nine. Confirm the picker when you are done.
Narrow to variants if you need to
To discount only part of a product, expand it in the picker and tick the individual variants. Or leave the picker to whole products, then, back on the form, expand a product with Variants (4) and untick the variants you do not want discounted.
Save
Click Save. Nothing reaches your store until the whole form passes validation.
The picker reopens with your selection
The picker reopens with your current selection ticked, the products and, inside them, the variants you narrowed to, so adding one more product is a matter of ticking it. Whatever you confirm becomes the discount’s whole product list. Closing the picker without confirming leaves your existing selection exactly as it was.
Product names come from your catalogue
Product names and variants are read back from your store’s synced catalogue rather than stored on the discount. If that read fails, the list still renders, labelled honestly: “Product names couldn’t be loaded, so these are shown by id. Your selection is unaffected.” A naming problem never touches your selection.
One discount per product for each kind of buyer
A product that another active or draft discount for the same buyers already covers, as one of its products or as one of its Buy X get Y gifts, is not offered in the picker at all. Two such discounts on one product would both reach it, and only one of them could ever apply to an item. A discount for Retail shoppers only and one for B2B buyers only may share products, as each buyer only gets their own: the picker follows what Who can get it says when you open it. Archive the other discount to release its products.
The discount you are editing always sees its own products, so editing it is never blocked.
This rule is about products you pick one by one. A collection or all-products discount can reach a product that has its own discount, and your Overlapping discounts choice decides which one the item gets. See Collections and All Products.
The picker only opens inside Shopify
xDiscount runs inside the Shopify admin only. Opened anywhere else it shows Open xDiscount from your Shopify admin instead of the app, and the picker itself refuses with “The product picker is only available inside the Shopify admin.” Reopen xDiscount from Apps in your admin.
Collections and All Products
Under Applies to, choose Collections or All products instead of Specific products.
Open the Included products section
Open the discount and find the Included products section.
Choose Collections
Under Applies to, choose Collections.
Open the collection picker
Click into the Select collections field, or press Browse, to open Shopify’s collection picker. Choose collections does the same while the list is empty.
Pick your collections
Tick the collections you want and confirm.
Save
Click Save.
Every chosen collection is listed with a bin to remove it, and Remove all clears the list. A discount can name up to 100 collections.
What a collection or all-products discount covers. Every variant of every product it reaches, including products added to a collection later. Checkout asks Shopify whether each product in the cart is in the collection at that moment, so smart collections that fill themselves from tags, type or price are always current.
Which discount wins. Only one discount applies per item, and your choice under Settings → Overlapping discounts decides which. By default the biggest discount wins, so a 12% collection sale beats a product’s own 5%. Choose The product’s own discount first to keep a product’s own discount ahead of a collection one, and a collection one ahead of an all-products one, or My priority order to rank them all yourself. See Priority, Which Discount Wins.
What these discounts cannot do. There is no variant narrowing, no Skip products that are out of stock and no Inventory condition. All three need stock read product by product, which only a discount on specific products has. The form hides them, and a save that asks for them is refused with a sentence saying why.
Two shop-wide limits. All your live collection and all-products discounts share one configuration on your store, read at checkout. Checkout can check at most 100 different collections for your live discounts between them, counting the collections they apply to and the collections they leave out (see Leaving Products Out below), and the whole configuration has the same 10,000-byte limit as a product. A save that would pass either is refused before anything changes, and the message says what to remove.
Switching an existing discount. Moving a discount from Specific products to Collections or All products removes its product list when you save, and every product it covered is rewritten without it. Moving it back writes its products again and takes it off your store’s collection and all-products list.
Leaving Products Out
A Collections or All products discount can leave some products out. Below the collections you chose, or the all-products line, the Exclusions section says “Products here never get this discount, never count toward its quantity tiers or cart spend steps, and never trigger its gift. Conditions still count the whole cart.” A Cart spend discount has the section too, because it covers all products.
Open the Included products section
Open the discount and find the Included products section.
Choose Collections or All products
Under Applies to, choose Collections or All products.
Leave out single products
Click into Exclude products, or press Browse beside it, and tick them in Shopify’s product picker. A product here is left out whole, every variant of it.
Leave out whole collections
Click into Exclude collections, or press Browse beside it, and tick them in Shopify’s collection picker. Every product in them is left out, including products added to them later.
Save
Click Save.
Each choice is listed under its field with a bin to remove it. A discount can leave out up to 50 products and up to 10 collections. To leave out more products than that, put them in a collection and leave the collection out. A collection the discount applies to cannot be left out too, and the save says which one. A discount on Specific products has no Exclusions: it already covers only what you picked, so moving a discount to Specific products removes them.
Example: All Products Except the Sale Collection
You want 10% off everything in your store, but not on what is already in your Sale collection.
Create the discount
Click Create discount, choose Percentage off and enter 10 in Percentage off.
Apply it to all products
Under Applies to, choose All products.
Leave the Sale collection out
Under Exclude collections, press Browse, tick Sale and confirm.
Publish it
Set Status to Active and click Save.
A product in Sale pays full price, and every other product gets 10% off. On the Discounts list, the Products column reads “All products, except 1 collection”, and the form’s right-hand column says the same.
What leaving a product out means. A left-out product is treated exactly like a product the discount never covered:
| Discount | What happens to a left-out product |
|---|---|
| Percentage off or Fixed amount off | It does not get this discount. The next discount that reaches the item can still apply, and it does not count toward this discount’s volume steps |
| Buy X get Y | It does not count toward the items the shopper must buy. The gifts you chose are not affected |
| Free shipping | It does not bring free shipping on its own. A cart that holds only left-out products does not get it |
| Cart spend discount | It gets no money off, and does not count toward the amount the cart must reach |
On the storefront, the offer card, the discount badges and the cart progress bar leave these products out too. See The Storefront Offer Card.
Whole Products vs Specific Variants
This is the single most important targeting decision, and the app infers it from how you used the picker and the list rather than asking you.
| What you did | What gets stored |
|---|---|
| Left the product without expanding its variants | Whole product, meaning every variant |
| Expanded it and ticked every variant | Whole product. Ticking the last unticked variant puts the product back to whole-product targeting |
| The product has one variant only | Whole product |
| Expanded it and ticked some variants | Only those variants |
An empty variant list means every variant, including variants you add in Shopify tomorrow.
Unticking every variant is refused, with a sentence on that product rather than a silent rewrite:
Keep at least one variant, or remove the product from this discount.
Why whole-product targeting is worth preferring:
- New variants are covered automatically. Add a new size next month and a whole-product target picks it up. A list of specific variants never will, and the new one is silently left out.
- It costs almost nothing against the size limit. A whole-product target stores no variant list at all. See Size Limits below.
- It is what a merchant usually means. “20% off these five products” is nearly always every variant of those five.
Narrow to variants when the offer genuinely differs by variant, so clearing one colour, discounting the large size only, or running a promotion on a single SKU.
Excluding a variant is done by not selecting it. A discount on specific products has no exclusion picker of its own. Narrow the product to the variants you want discounted, and everything you left unticked is untouched. The Exclusions pickers belong to collection and all-products discounts, and they leave out whole products. See Leaving Products Out above.
On the storefront, the offer card follows the variant the shopper selects. An offer narrowed to other variants is dimmed and flagged Not available for the selected variant the moment they pick one you left out, and comes back when they pick one you included, so the card never advertises a discount checkout will not give.
Targeting is read in pages of 250
A discount’s targeting is read 250 rows at a time, one row per whole product, or one row per variant where you narrowed. A discount that targets whole products only stays far inside that, which is one more reason to prefer it.
Skipping Out-of-Stock Variants
In the Discount configuration section there is a checkbox, Skip products that are out of stock, with the note “Checked when this discount syncs, and once a day after that. Variants with no stock won’t be discounted until the next check.” It is off by default.
Open the discount
From Discounts, click the discount’s name.
Tick the box
In Discount configuration, tick Skip products that are out of stock.
Save
Click Save. xDiscount reads the stock level of the variants on your targeted products there and then.
Variants with no stock stop being discounted. Every other variant on the product carries on as normal. The setting is per discount, so two discounts on the same product can disagree, and only the one with the box ticked skips anything.
This is the same mechanism as the Inventory condition, set to the special case “at least 1 in stock”. Stock is read at the same moments, from the same source, and the same rule about untracked variants applies.
| Event | Does stock get re-read? |
|---|---|
| You open the discount and click Save | Yes, immediately, for every product it targets |
| The daily refresh runs at 03:00 UTC | Yes, for Active discounts that use Inventory or Skip products that are out of stock |
| A shopper adds to cart | No |
| An order drains the last unit | No |
| You restock in Shopify | No |
The honest limits of this feature:
| Limit | What it means for you |
|---|---|
| It is a snapshot, not live | Stock is read when you click Save and again on the daily refresh, never at checkout. A variant that sells out an hour after a check is still discounted until the next one |
| It fails open | If stock cannot be read, nothing is excluded and the discount applies exactly as it did before. A promotion that quietly switches itself off mid-sale is worse than over-discounting a few sold-out variants, and Shopify will not sell an out-of-stock variant anyway unless you allow overselling |
| Untracked variants are never skipped | A variant with no inventory tracking, which covers most digital products and services, reports no quantity at all. That is not the same as zero, so it is never excluded. Only variants tracked at zero or below are |
| First 250 variants per product | On a product with more than 250 variants, only the first 250 are checked for stock |
Refreshing the snapshot yourself
Running a clearance discount? Open it and click Save with no other changes. That re-reads stock immediately for every product the discount targets, and the answer is correct again from that moment. The Conditions & Rules guide covers the full Inventory condition and what a day-old snapshot means in practice.
Size Limits, When a Discount Targets Too Much
Shopify gives every product a fixed budget for the configuration a discount can read at checkout: 10,000 bytes. xDiscount stores one configuration per product, holding every live discount that targets that product, so the variants each one is narrowed to, the conditions, and any gift products. Drafts and archived discounts are left out of it entirely and cost nothing.
Above 10,000 bytes Shopify still stores the configuration, but checkout stops being able to read it, so the discount would never apply, with no error shown anywhere. xDiscount refuses to let that happen quietly. It measures the configuration before writing anything to Shopify, and if it is over the limit it declines the write rather than trimming your settings.
What you see when this happens:
- Your discount still saves, so you never lose your work.
- On the Discounts list, its Sync column shows a warning badge reading TOO_LARGE.
- On Home, a red banner appears, Some discounts aren’t reaching your store, with a Review them button that opens the Discounts list filtered to exactly those discounts.
- You can find them yourself at any time: Discounts → the Sync filter → Too large.
The budget is per product, not per discount. Targeting 500 different products is fine, because each one gets its own 10,000 bytes. What consumes the budget is listing individual variants of one product, plus conditions, plus Buy X get Y gift products. As a rule of thumb, a list of around 100 variants costs about 4.3 KB, close to half the budget for a single product.
How to get a too-large discount back under the limit:
Open the discount
Click its name on the Discounts list.
Re-select the affected product as a whole product
In Included products, tick every variant of it back on in the list, or press Browse and re-select it without expanding it. A whole-product target stores no variant list at all, and it is the biggest single saving available.
Thin out the other discounts on that product
If several discounts target the same product, they share that one product’s budget. Archive or delete any of them you no longer need, and the product’s configuration is rewritten without them.
Trim conditions and gifts
In Conditions, remove any rows you do not need, because conditions are stored on every product the discount targets. For Buy X get Y, trim the gift product list.
Save
The Sync badge turns to SYNCED on the next successful save.
Saving again is also how you retry anything showing FAILED, because every save re-pushes the configuration to Shopify.
Inventory conditions cost bytes too
An Inventory condition writes the list of skipped variants into the configuration on each targeted product, so it consumes budget on top of your variant lists. It is worth knowing about when a large, heavily narrowed discount is close to the limit.
When Several Discounts Target the Same Product
Normally two that reach the same buyers can’t: a product belongs to one discount for each kind of buyer, and the picker doesn’t offer a product another live or draft discount for the same buyers already covers. A discount for retail shoppers only and one for B2B buyers only may share a product, and never meet. A product can still end up in two, an archived discount brought back after its products went to another discount, or one saved before this rule, and xDiscount then keeps both in the product’s one configuration. At checkout only one discount applies per item. Archiving or deleting one discount rewrites that product’s configuration with the survivors, so the others keep working untouched.
Your Overlapping discounts choice picks that discount among those that match, with the lower priority number settling a tie. See Priority, Which Discount Wins.
A Discount code is never in a product’s configuration: it applies only when a shopper enters its code. 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.
One case is worth knowing about in advance. If two discounts on the same product both use an Inventory condition with different ranges, both obey the combination of the two, so the looser one skips more variants than it asked for. That keeps the product’s configuration inside the 10,000-byte limit, and it errs towards discounting less rather than more.
Quick Reference
| Question | Answer |
|---|---|
| Where do I choose products? | Discounts → open a discount → Included products |
| Controls | The Select products and variants field and Browse, Choose products while the list is empty, a checkbox per variant and a delete button per product in the list, and Remove all |
| Can a discount target zero products? | No, saving is blocked |
| Can I target a collection or “all products”? | Yes. Choose Collections or All products under Applies to |
| Can a discount code target products? | Yes, like any discount: specific products, collections or all products. It applies only when its code is entered |
| Which wins between a product, a collection and an all-products discount? | Your choice under Settings → Overlapping discounts: the biggest discount (the default), the product’s own discount first, or your priority order |
| How do I exclude a variant? | Select the variants you do want. The rest are untouched |
| Can a collection or all-products discount leave products out? | Yes. Under Exclusions: up to 50 products and up to 10 collections |
| Will a new variant get the discount? | Yes for whole-product targets, never for variant lists |
| Are gift products targeted here? | No. Buy X get Y gifts are chosen in Discount configuration and need no targeting of their own |
| Does out-of-stock skipping run at checkout? | No. It is recorded when you click Save, and refreshed daily at 03:00 UTC |
| What is the size limit? | 10,000 bytes per product, shared by every live discount on that product |
| Where do I see size problems? | The Sync badge TOO_LARGE, and the Home banner Some discounts aren’t reaching your store |