Shopify Subscription Discounts: First Payment or Every Payment?
Why your discount skips subscription products, how Purchase type and recurring payments work, and why deactivating a code won't help existing subscribers.
How-to guidesThe diex team11 min read
You built a 20% welcome offer, a customer added your subscription product to the cart, and the code did nothing. Or it worked, and now you are wondering whether that 20% comes off next month's charge too. Two settings decide both outcomes: Purchase type, which controls whether the discount reaches subscription items at all, and Recurring payments for subscriptions, which controls how many billing cycles it survives. There is also a third behavior that is easy to miss, and it is the one that costs real money: once a code lands on a subscription, turning the code off later does not remove it from that subscriber.
Why your discount code skips subscription products
A subscription line item is not an ordinary line item. Shopify treats "selling plan" purchases as a separate purchase type, and every amount off, free shipping and buy X get Y discount carries a flag for which purchase types it applies to. In Shopify's Admin API those flags are literally named appliesOnOneTimePurchase ("Whether the discount applies on regular one-time-purchase items") and appliesOnSubscription ("Whether the discount applies on subscription items"), per the DiscountCustomerGetsInput reference. If the subscription flag is off, the code is valid, the cart contains eligible products, and nothing happens.
The admin side of that flag is a Purchase type section in the discount editor. Shopify's help page for percentage and fixed amount discounts describes it as an optional step: "If you have subscriptions set up on your store, then under Purchase Type you can select if the discount applies to One-time purchase, Subscription or Both." Note the condition. The section only appears once subscriptions exist on the store, which is why a discount created before you launched subscriptions will not reach subscription items until you open it and set Purchase type.
There is a second, unrelated cause worth ruling out. If the discounted price you see on the product page comes from the subscription plan itself rather than from a discount in the Discounts section, a misconfigured plan can show a price that the cart does not honor. One merchant in a Shopify Community thread about subscription discounts not applying at checkout reported exactly that, and fixed it by building one plan per product with the variants configured inside that plan, instead of a separate plan per variant. So before you edit any code, check which mechanism is supposed to be producing the discount: a plan discount set in your subscription app, or a discount in the Discounts section of your admin.
Set Purchase type so the discount reaches subscriptions
Shopify's subscription discounts documentation lists three discount types that have subscription options: buy X get Y, amount off, and free shipping. Amount off and free shipping can each apply to subscription purchases, one-time purchases, or both.
To fix an existing discount:
- From your Shopify admin, go to Discounts.
- Click the discount you want to edit.
- In the Purchase type section, choose the purchase type you want to limit the discount to.
- If you select Subscription, choose which subscription products it covers: All subscription products, All subscription products in a specific collection, or Specific subscription products. For the last two, use the Browse button that appears.
Two decisions follow from this. Picking Both means one code works for a shopper who wants a single bag of coffee and for one who wants a monthly bag. Picking Subscription means the discount becomes a reason to subscribe, because the one-time version of the same product stays at full price. Shopify's own example on that page is that "you can offer a 10% off discount when a customer chooses a subscription instead of a one-time purchase."
The same Purchase type choice exists on automatic discounts, not just codes, and Shopify confirms in its subscription considerations page that "Automatic discounts that you create in the Discounts section of your Shopify admin can be applied to subscription orders." An automatic discount is usually the better fit for a permanent "subscribe and save" price, since there is no code to type and no code to leak. A code is the better fit for a time-limited acquisition offer. If you are weighing the two, we covered the trade-offs in automatic discounts versus discount codes.
First payment, a set number of payments, or forever
The second setting lives in Usage limits, under Recurring payments for subscriptions. Shopify's subscription discounts page describes three choices: "You can choose to limit your free shipping discount to the first payment, to limit your free shipping to a certain number of payments, or to activate free shipping on all future subscription payments."
That step-by-step is written for free shipping discounts. The underlying control is not specific to free shipping, though. The Admin API field behind it, recurringCycleLimit, appears on both the free shipping code input and the basic amount off code input, where it is described as "The number of billing cycles for which the discount can be applied, which is useful for subscription-based discounts" in the DiscountCodeBasicInput reference. If you do not see the option on an amount off discount, confirm Purchase type is set to Subscription first, since the subscription controls only surface after that.
Shopify is blunt about why this matters. On the same subscription discounts page: "The Recurring payments for subscriptions setting is the only way to automatically limit how many billing cycles a discount applies to." Nothing else in the discount editor does it. Not the end date, not the usage limit, not deactivating the code.
One more rule applies if your offer comes from an app rather than from Shopify's native discounts. Per the considerations page for the Shopify Subscriptions app, "For recurring payments, Shopify reuses discounts from apps that use functions instead of running the app's function again. The app sets how many payments its discounts apply to. By default, discounts apply only to the first payment." That covers any discount that runs as a Shopify Function rather than as a native Shopify discount, so check the app's documentation for how many payments it sets. If your subscribe-and-save needs to hold on every renewal, build it as a native Shopify amount off discount or as a discount on the subscription plan, and verify the second billing cycle on a real test subscription.
The snapshot: why deactivating the code does not help existing subscribers
This is the fact that turns a welcome offer into a permanent price cut. From Shopify's subscription discounts page:
When a discount code is applied to a subscription, a snapshot of the discount is saved to the subscription contract. This snapshot is independent of the original discount code. If you expire or deactivate a discount code, the discount will continue to apply on existing subscription contracts.
Read that twice if you run flash promotions on subscriptions. A code set to apply to all future payments, used during a one-week launch promo, is now attached to every contract created that week. Ending the promotion stops new signups from getting it. It does nothing to the subscribers who already have it. Shopify's instruction for cleaning that up is short: "To remove a discount from an existing subscription contract, use your subscription app." That means editing contracts one at a time in whatever app manages your subscriptions, with a customer-service conversation attached to each one, or accepting the discount for as long as those subscribers stay.
The practical rule: set the recurring payments limit before the discount goes live, not after. There is no retroactive fix in the Discounts section.
What free shipping on subscriptions can and cannot do
Free shipping is the most flexible of the three types, and the one Shopify documents most thoroughly for subscriptions. You can cover the first payment, a set number of payments, or all future subscription payments. You can also "exclude free shipping for shipping rates over a certain monetary value" and choose the countries the discount applies to, per the free shipping discount documentation.
What it cannot do is control which rate gets discounted on renewals. Shopify's subscription considerations page explains that when a customer selects an available shipping method on an order that includes subscriptions, "that shipping method applies to the initial delivery," while "recurring shipments for subscriptions revert to the default shipping method," and "recurring shipments default to the least expensive available shipping method." At checkout, subscription orders show a First shipment section where the customer chooses a method, and a Recurring payments section that displays "the shipping method, transit time, cost, and delivery frequency for each recurring shipment."
So a customer who picks express for the first box does not keep express for free on every renewal. The renewal shipping you cover is priced at the cheapest available rate, which makes free shipping on all payments cheaper than the first-shipment rate suggests. It also means your "free express shipping" promise is only true for shipment one.
Price the offer against lifetime value, not the first order
The gap between first-payment-only and forever is larger than the percentage suggests, because subscription margin compounds.
For example, say a monthly box sells for $40, and product plus pick, pack and shipping costs you $22. Contribution is $18 per cycle. An average subscriber stays 10 cycles.
| Offer | Cycle 1 contribution | Cycles 2 to 10 | Total per subscriber |
|---|---|---|---|
| 30% off first payment | $6 | $18 each | $168 |
| 30% off all payments | $6 | $6 each | $60 |
A 30% discount costs you $12 once in the first case and $120 across the relationship in the second, $108 more than the first-payment-only version. Put differently: for the forever version to earn the same $168, that subscriber would have to stay 28 cycles instead of 10.
That math does not automatically favor first-payment-only. A permanent subscribe-and-save price is a retention tool, and if a deeper standing discount lifts average subscriber life from 10 cycles to 28, it pays for itself. The point is that you should know which number you are betting on before you pick the setting. Run the same arithmetic with your own contribution and your own average subscriber duration, and treat any per-cycle discount larger than your per-cycle contribution in dollars as a cycle you are paying for. Our guide on how deep a discount can go before it costs you money walks through the breakeven version of this.
Buy X Get Y and other limits to plan around
A few constraints are worth knowing before you design the offer. The first two come from Shopify's subscription discounts page, the next two from the Shopify Subscriptions app considerations page:
- Buy X get Y: the "buy X" product can be a subscription or a one-time purchase, but "the added product, or 'get Y' part of the discount, must be a one-time purchase." A free mug with a coffee subscription works. A free mug with every delivery, as part of the same discount, does not. Our buy X get Y setup guide covers the rest of the configuration.
- No shipping coverage on product discounts: both buy X get Y and amount off discounts do not apply to shipping costs. Shipping needs a free shipping discount.
- Gift cards: "Gift cards that are used to pay for subscriptions apply only to the first payment."
- Bundles: "Bundles aren't compatible with the Shopify Subscriptions app." If you are running the first-party app, plan the offer around individual products and collections.
- Plan discounts are a separate lever: in the first-party Shopify Subscriptions app, you can apply a discount to the subscription plan itself by choosing Percentage off, Amount off or Fixed price in the plan's discount and frequency options. That is the usual home for a standing subscribe-and-save price, and it is independent of the Discounts section. Third-party subscription apps have their own equivalent, so check their docs.
None of this touches the one-time side of your catalog, where quantity and order-value thresholds do the work instead. diex runs volume, variable and spend tier discounts as Shopify Functions, so Shopify applies them in the cart and at checkout.
Check this before you launch
Work through this on a test order before the promotion goes out:
- Open the discount and confirm Purchase type is set to Subscription or Both, and that the product or collection scope actually includes the subscription products you mean.
- Set Recurring payments for subscriptions deliberately: first payment, a specific number of payments, or all future payments. Write the choice into the campaign brief so nobody assumes the end date limits it.
- Place a real test subscription with the code, then check the subscription contract in your subscription app to confirm the discount was saved the way you expect, and on how many cycles.
- If the offer is a function-based app discount, verify the second billing cycle rather than assuming it carries over.
- For free shipping offers, decide whether you are covering the first delivery or all of them, and remember renewals fall back to the cheapest available rate.
- Multiply the per-cycle discount in dollars by your expected subscriber life, then compare that total to the contribution those cycles would otherwise have produced. Approve the offer only if you are happy with what is left.
Sources
- Subscription discounts - Shopify Help Center
- Considerations for selling subscriptions - Shopify Help Center
- Considerations for the Shopify Subscriptions app - Shopify Help Center
- Amount off products and orders discounts - Shopify Help Center
- Free shipping discounts - Shopify Help Center
- Create and edit subscription plans - Shopify Help Center
- DiscountCustomerGetsInput - Shopify Admin GraphQL API
- DiscountCodeBasicInput - Shopify Admin GraphQL API
- Shopify subscriptions app not applying discount at checkout - Shopify Community
Drafted with AI from the sources above and checked automatically against them and our product facts. Spotted a mistake? Email help@diex.app.