How to Apply a Shopify Discount to One Item Only
Which Shopify setting takes money off a single item instead of every eligible one, why percentage codes have no once-per-order box, and the buy X get Y fix.
How-to guidesThe diex team11 min read
You build a $10 off code for your candle collection, a customer adds six candles, and the code takes $60 off the order. That is Shopify working as designed, not a bug. Shopify's discounts FAQ is blunt about it: "Product-specific discount codes apply to all quantities of a product when a customer applies the discount code. For example, if a customer adds 10 of the same product, then the product specific code discounts all 10 items" (Shopify Help Center, Discounts FAQ). There is a setting that stops this, but it only exists for one discount type. Here is which one, what to do when your discount is a percentage, and the usage limits that handle the other thing merchants mean by "one item."
Decide which "one item" you actually mean
"One item only" means three different things, and each has a different fix. Sort yours before you touch the admin.
| What you mean | What you want to limit | Where the setting lives |
|---|---|---|
| One unit: the customer buys four, only one is discounted | Quantity inside a single line item | Fixed amount: "Only apply discount once per order". Percentage: buy X get Y with a maximum uses per order |
| One product: the code applies to a hoodie, not to everything in the cart | Which products are eligible | "Applies to" in the discount, set to specific products or collections |
| One redemption: the code works once, then it is dead | How many times the code can be used | "Limit number of times this discount can be used in total" and "Limit to one per customer" |
The second and third rows are straightforward. The first row is where Shopify's behavior surprises people, so start there.
Fixed amount off products: check "Only apply discount once per order"
If your discount is a fixed amount (say $10 off, not 10% off) and it targets specific products or collections, Shopify gives you the exact checkbox you are looking for.
- In your Shopify admin, go to Discounts and click Create discount.
- Choose Amount off products.
- Pick Discount code or Automatic discount, then enter the code or title.
- Under Discount value, select Fixed amount and enter the amount.
- Under Applies to, choose Specific products or Specific collections and pick them.
- Check Only apply discount once per order.
- Set your dates, save, and test with a cart holding several units.
Shopify's instructions describe step 6 this way: "Optional: To create a fixed value discount code that can be applied to specific products or collections, check Only apply discount once per order to limit the customer to using the code only one time per order" (Shopify Help Center, Amount off products discounts). The same box appears in the automatic discount flow, where the docs add the other half of the sentence: "Otherwise, the discount applies to all eligible products in the order."
Two things to note. The checkbox is tied to the fixed amount value type and to a specific products or collections target, so it will not appear if you leave Applies to on all products. And "once per order" is about how many times the amount comes off, not about how many times the code can be redeemed. A customer can still use the code on their next order unless you add a usage limit.
Why a percentage off code has no once-per-order option
There is no equivalent checkbox for a percentage. Shopify scopes the option to fixed value discounts on specific products or collections, and that is the whole scope. If you create 20% off a collection, the 20% comes off every eligible unit in the cart. Four hoodies, four discounted hoodies.
The checkbox is not a general fix for any discount. If it is not showing up for you, check your value type before you go looking for a bug.
One thing worth separating out: if the cart only ever contains a single unit of a single eligible product, a percentage code on that product already behaves like a one-item discount. The problem only bites when the customer has multiple units, or when your Applies to selection covers more products than you intended. Tightening Applies to down to one product, or even one variant, solves a surprising share of "it discounted too much" tickets without any other change. For the trade-offs between the two value types in general, see our breakdown of percentage versus fixed amount discounts.
Use buy X get Y to discount a single unit by a percentage
When you need a percentage off exactly one unit, buy X get Y is the route. Its Customer gets section has both a quantity and a cap on how often the offer repeats in one cart.
- Go to Discounts, click Create discount, and choose Buy X get Y.
- Choose Discount code or Automatic discount.
- In the Customer buys section, set Minimum quantity of items (or Minimum purchase amount) and choose the products or collections that qualify.
- In the Customer gets section, set the quantity to 1 and choose the product or collection to discount.
- Under At a discounted value, select Percentage and enter your value. The other two options are Amount off each and Free.
- Check Set the maximum number of uses per order and enter 1.
- Set eligibility, usage limits and dates, then save.
Step 6 is the one that does the work. Shopify's buy X get Y page frames the choice like this: you can "offer customers one free hat for the whole order, or you can offer them one free hat for each T-shirt" (Shopify Help Center, Buy X get Y discounts). Without the cap, a cart with five qualifying T-shirts earns five discounted hats. With it set to 1, the offer fires once no matter how large the cart gets.
Three caveats before you ship it:
- The discounted item is not added for the customer. Shopify is explicit: "Customers must add all items to their cart manually. The free or discounted 'get' item is never automatically added to the cart." Say so in your offer copy, or customers will think the code is broken.
- If you put the same product in both sections, the cart needs the buy quantity plus the get quantity. A "buy 1, get 1 at 25% off" on the same mug means two mugs in the cart, not one. Shopify adds that if the get selection "is the same as the one set in the Customer buys section, then the lower-priced item that the customer chooses is the item that the customer gets at a discount."
- On stores that are not on Shopify Plus, "All products that are part of a Buy X get Y discount are ineligible for further product discounts" (Shopify Help Center, Discount combinations). If that offer needs to sit alongside a sitewide sale, test it.
Our walkthrough of buy X get Y setup covers the rest of the fields in that form.
What happens when you leave the once-per-order box unchecked
Unchecked is the default, so this is the behavior most merchants meet first. Shopify states it in the same paragraph that introduces the checkbox: "Otherwise, the discount applies to all eligible products in the order" (Shopify Help Center, Amount off products discounts). The discounts FAQ quoted at the top of this article says the same thing from the quantity side: all quantities of an eligible product get the discount.
For example, say you sell a $40 bestseller and run a $15 off code on its collection with the box unchecked. A customer who adds three of them gets $45 off, not $15, and your margin on that order is gone. Checking the box turns the same code into a flat $15 however many units are in the cart.
So the number you type is not the number you risk. Decide what the code is worth to you as a worst case, with a cart full of eligible units, rather than as a typical case, then set the box to match. If you are sizing the number itself rather than its scope, we wrote about how deep a discount can go before it costs you money.
A different case: amount off discounts that apply to all products
There is a second behavior that is easy to confuse with the one above, and it belongs to a different configuration. When an amount off discount is not limited to specific products, the once-per-order checkbox is not available at all, and Shopify splits the amount across the cart instead. The condition is in Shopify's own wording: "If your amount off discount applies to all products, then the discount is applied proportionally across all items in the cart." Their example is a "$50 USD discount applied to a cart with a $50 USD item and a $100 USD item, then the first item is discounted by $16.50 USD and the second one by $33.50 USD" (Shopify Help Center, Amount off products discounts).
Those two cases pull in opposite directions, which is why it is worth keeping them apart:
- An all-products $50 amount off discount takes $50 off the order in total, divided across the lines in proportion to their prices.
- A specific-products $50 amount off discount with the box unchecked takes $50 off each eligible product, so the total grows with the cart.
Either way, place a test order before you launch and read the discount total on the order, not the value in the form.
Set the usage limits that stop repeat redemptions
If your real concern is a code circulating on a deal site, per-order caps will not help you. Usage limits will. Both amount off and buy X get Y discounts offer the same two checkboxes (Shopify Help Center, Amount off products discounts):
- Limit number of times this discount can be used in total. Enter a number and the code stops working after that many uses across all customers. The same customer can still use it more than once until the total runs out.
- Limit to one per customer. One redemption per customer. Shopify enforces it by tracking the customer's email address or phone number at checkout.
Combine them with the once-per-order setting as needed. They answer different questions: one is "how much comes off inside a single order," the other is "how many orders can use this at all."
Check the combination settings before you launch
A one-item discount can quietly become a many-item discount when a second promotion is live. Shopify's combination rules allow product discounts with other product discounts "on separate items" for all merchants, while "Product discounts combined with other product discounts on the same item" is a Shopify Plus capability (Shopify Help Center, Discount combinations). Order and shipping discounts follow their own rules, and "Multiple shipping discounts can't apply to the same order."
Before you publish, open the combinations section of your new discount, uncheck anything you do not want stacking, and place a test order with your other active promotions running. Our guide to what actually stacks in Shopify discounts goes through the matrix.
One case Shopify's built-in discounts do not cover: a single code that takes a different amount off each product, for example a deeper cut on slow stock and a shallow one on your bestseller. That is not a single-item cap, it is per-product values, and it is what diex variable discounts do, with one code and a different value per product or variant. For everything in this article, though, Shopify's native discounts are the right tool and you do not need an app.
Next steps this week
- Write down which of the three meanings of "one item" your promotion needs. The fix follows from that sentence.
- If it is a fixed amount on specific products, create it and check Only apply discount once per order.
- If it needs to be a percentage on one unit, build it as buy X get Y with Set the maximum number of uses per order at 1, and add a line to your offer copy telling customers to add the discounted item themselves.
- Place one test order with several units of the eligible product and confirm the discount total is the number you expected, not a multiple of it.
- Add a total usage limit or a one-per-customer limit if the code will be shared outside your own channels.
Sources
Drafted with AI from the sources above and checked automatically against them and our product facts. Spotted a mistake? Email help@diex.app.