- Subscription Upsell (this guide). Add a new subscription line item to a one-time order. The customer keeps their one-time purchase and gets a new recurring subscription on top.
- Subscription Upgrade. Modify a customer’s existing subscription after checkout (change frequency, swap product, or both).
- Replacement Upsell. Swap a one-time product in the order for another product. The replacement can be a subscription version of the same product, a different one-time product, or a different variant or quantity. Replacement Upsell cannot operate on a subscription line, if the order already contains a subscription, use Subscription Upgrade instead.
What is a Subscription Upsell?
Subscription Upsell uses Shopify’s native Subscription API to add a new recurring subscription to the customer’s order on the post-purchase page. The customer accepts in one click without re-entering payment or shipping. Their one-time purchase stays in the order as is, and the new subscription line item is added alongside it. The customer journey is four short steps:- Customer completes checkout on a one-time product.
- Sees the Subscription Upsell offer on the post-purchase page.
- One-click accepts without re-entering payment or shipping details.
- Their first subscription order ships, and future renewals are billed by your subscription provider on the cadence you configured.
add_subscription post-purchase changeset. Aftersell does not call your subscription app’s API directly for this flow, the subscription is created by Shopify and your subscription app picks it up via its own Shopify integration. This is why Subscription Upsell works with any subscription app that uses Shopify’s native Subscription API.
The first cycle of the subscription is fulfilled from the original Shopify order as a normal line item. Subsequent renewals are managed by your subscription provider, the same as any subscription created during regular checkout.
When to use a Subscription Upsell
Subscription Upsell works best when:- Your one-time product is a consumable or replenishment (skincare, supplements, pet food, coffee, household goods). Customers already need it again, so the recurring offer feels natural.
- The customer just demonstrated purchase intent by completing checkout, which makes them more receptive to a related subscription than they would be on a cold landing page.
- You can offer a clear value exchange, typically a first-cycle discount, free shipping on subscription orders, or a small free gift on the first delivery.
Compatible subscription platforms
Subscription Upsell is fully provider-agnostic on the Aftersell side. Aftersell adds the subscription via Shopify’s nativeadd_subscription post-purchase changeset, and Shopify routes the enrollment to whichever subscription app you have installed on the Shopify Subscription API. This means any subscription app that uses Shopify’s native Subscription API will work without additional setup, including Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (when running on Shopify’s native subscriptions API), and Shopify’s native selling plans.
Selling plans you create in your subscription app are pulled into Aftersell automatically.
For Subscription Upgrade compatibility, which is different and provider-specific, see Subscription Upgrades.
Creating a Subscription Upsell offer
To create a Subscription Upsell, build a standard post-purchase offer and select a product that has selling plans enabled in Shopify. There is no separate template, the offer adapts to the product you pick. To open the offer editor:- In your Aftersell dashboard, go to Post-Purchase Upsells.
- Open an existing funnel or click Add Funnel to create a new one.
- Click Add Upsell and select the product you want to offer.
Offering subscription products after checkout
If a product has selling plans enabled in Shopify, you can offer it in one of three ways. Choose the right mode for each offer.1. One-time purchase only
The product is offered as a one-time purchase. No subscription option is shown, even though the product has selling plans in Shopify. The experience feels like a typical post-purchase offer. Pick this when you want to feature a subscription-enabled product but not commit the offer to recurring revenue (for example, a sampler or trial size).2. Subscription only
The product must be purchased as a subscription. Customers cannot choose a one-time purchase. The available subscription options come directly from Shopify. Pick this when you want to fully commit the offer to recurring revenue.3. One-time purchase and subscription
Customers can choose between a one-time purchase or a subscription. The pricing and delivery frequency come from Shopify. This is the most flexible option and the easiest place to lean on a subscription default and a first-cycle discount to nudge customers toward the recurring choice.Choosing a default option
If you offer both one-time and subscription options, you can decide which one is preselected when the offer loads. This default selection:- Guides customer behaviour. Pre-selecting the subscription leans on default-bias and lifts subscription acceptance.
- Highlights your preferred option (such as the subscription).
- Still allows customers to switch before accepting.
Subscription plan locking
When offering subscription products with multiple subscription plans, you can lock the offer to a specific plan. This prevents customers from changing the subscription plan during the post-purchase experience.How subscription plan locking works
When you lock a subscription plan:- Customers see the plan name displayed as static text.
- The plan selector dropdown is hidden.
- Customers cannot change the subscription plan.
- They receive the exact subscription option you have configured.
Configuring subscription plan locking
To lock a subscription plan:- Open your post-purchase offer in the editor.
- Navigate to the Variant & Plan Options section.
- In the Lock subscription plan dropdown, select a specific plan.
- Save your offer. The plan is now locked for this offer.
Fallback behaviour
If the locked plan is no longer available in Shopify (for example, if it has been removed or disabled), the offer gracefully falls back to showing all available plans. This ensures customers can still complete the purchase.Automatic reset
The locked plan setting automatically resets if you change the product’s purchase option to one-time purchase only. This prevents configuration errors when subscription options are removed.Which selling plan is shown by default
When you do not lock a specific plan, the post-purchase offer shows the first selling plan configured on the product in Shopify. Customers do not see a frequency picker in the offer itself by default. To control which plan customers see:- Lock a specific plan (recommended). Use the Lock subscription plan dropdown to pick exactly one. Customers see only that plan.
- Reorder selling plans in Shopify. The order of selling plans on the product determines which one is shown first.
- Remove unused selling plans from the product. If you have multiple frequencies and only want one to surface, the simplest path is to keep only the relevant selling plan attached to the product.
Subscription discounts
When you apply a discount to a Subscription Upsell offer, the discount applies to the first billing cycle only. Future recurring orders are charged at the regular subscription price. Customers can see this in the offer experience under the Recurring subtotal, which shows what future renewals will cost. This is different from the recurring discount used by Subscription Upgrade. For Subscription Upgrade discount behaviour, see Subscription Upgrades.What price the customer actually sees
Where the price appears in the offer matters for how the customer reads it. The post-purchase offer shows two distinct prices:- The Accept Offer button and the line-item subtotal reflect the first-cycle price, including any first-cycle discount you have configured.
- The Recurring subtotal field shows what the customer will be charged on subsequent renewals at the regular subscription price.
Discount types
You can configure discounts in two ways:- Percentage discount. Reduces the subscription price by a percentage (for example, 15% off).
- Fixed amount discount. Reduces the subscription price by a specific dollar amount (for example, $5 off).
How much to discount
Common discount ranges for post-purchase subscription offers:- 10 to 15 percent first-cycle discount is the most common range and produces solid acceptance lift without significant margin loss.
- 20 to 25 percent first-cycle discount is the upper bound, used to push acceptance higher on competitive products or when the recurring cadence is short (weekly, biweekly).
- Free gift on first delivery is an alternative that some merchants find lifts acceptance further than a price discount, because it changes the conversation from “save money” to “get something extra”.
Worked examples
Four common Subscription Upsell scenarios, with the exact configuration and what the customer experiences.Scenario 1: Standard one-time + subscription with first-cycle discount
Setup. Your customer bought a one-time bottle of moisturizer at $30. You want to offer them a monthly subscription of the same product at $25 per month, with a 20% first-cycle discount as an acceptance incentive. What you set in the offer:- Purchase option: One-time purchase and subscription.
- Default option: Subscription.
- Selling plan: Monthly, $25.
- First-cycle discount: 20% off.
- The subscription option is preselected.
- Accept Offer button: $20.00 (first cycle, 20% off $25).
- Recurring subtotal: $25.00 every 30 days.
- Shopify charges them an additional $20 on this order.
- A monthly subscription is created in your subscription app at $25.
- The next charge happens in 30 days at $25.
- Original bottle (one-time): $30.
- Subscription bottle (first cycle): $20.
- Order total: $50.
Scenario 2: Free first delivery (100% off first cycle)
Setup. Your customer bought a one-time skincare kit. You want to offer them a monthly serum refill with a free first delivery to incentivize trial. What you set in the offer:- Purchase option: Subscription only.
- Selling plan: Monthly serum, $40.
- First-cycle discount: 100% off.
- Accept Offer button: $0.00.
- Recurring subtotal: $40.00 every 30 days.
- Offer copy (recommended): “First month free, then $40 every 30 days. Pause or cancel anytime.”
- Shopify charges $0 for the subscription line on this order.
- A monthly subscription is created in your subscription app at $40.
- The next charge happens in 30 days at $40.
Scenario 3: Locked selling plan (you control the cadence)
Setup. You sell coffee that has three selling plans configured in Shopify: weekly, biweekly, and monthly. For your post-purchase offer, you only want to surface the monthly plan because it gives the best margin. What you set in the offer:- Purchase option: Subscription only.
- Lock subscription plan: Monthly.
- Plan name shown as static text (“Monthly”).
- No plan selector dropdown.
- Accept Offer button: monthly price.
- A monthly subscription is created.
- The customer can change the cadence after acceptance in your subscription app’s customer portal.
Scenario 4: Customer already has a subscription in their cart
Setup. A customer is buying both a one-time face wash AND a subscription serum in the same order. After checkout, your post-purchase funnel has a Subscription Upsell offering a vitamin subscription. What happens at runtime:- Aftersell detects the existing subscription line in the order.
- If the offer is configured as subscription only, the offer is dropped from the funnel for this customer. They never see it.
- If the offer is configured as one-time and subscription, the offer is auto-downgraded to one-time only. The customer sees the vitamin product available as a one-time purchase, with no subscription option.
What the customer sees
When a customer accepts a Subscription Upsell, three things happen across two systems.On the Shopify order
The customer’s Shopify order confirmation will include both:- The original one-time line item they bought at checkout.
- The new subscription line item added by the upsell, billed at the discounted first-cycle price.
In their email confirmations
Shopify sends the standard order confirmation email with both line items. Your subscription provider typically sends its own subscription welcome email that explains the recurring schedule and how to manage the subscription. If you offer a subscription, make sure your subscription provider’s welcome email is configured to send within minutes of acceptance with:- The customer’s name and the product they subscribed to.
- The cadence (every 30 days, every 60 days, etc.).
- The next charge date.
- A direct link to the customer portal where they can pause, skip, or cancel.
In the subscription provider portal
After accepting, the customer can manage the new subscription in your subscription provider’s customer portal. They can typically:- Pause or skip a delivery.
- Change the cadence.
- Swap products.
- Cancel the subscription.
Subscription fulfillment
How the first cycle ships depends on your store setup.- First cycle. The first subscription order is part of the original Shopify order, so it flows through whatever fulfillment process you use for one-time orders (3PL, in-house, dropship). The subscription line item ships alongside the original one-time purchase.
- Subsequent renewals. Future cycles are created by your subscription provider on the renewal cadence. Each renewal becomes a new Shopify order, fulfilled the same way as any other order in your store.
Converting a one-time purchase into a subscription
You can also replace a one-time purchase with a subscription version of the same product after checkout. This is functionally a Replacement Upsell, not a Subscription Upsell, because the original one-time line is removed (refunded) and replaced with the subscription. The customer ends up with only the subscription, not both. This is the right choice when the customer’s order should ultimately be a recurring purchase rather than a one-off, and you do not want them to receive two separate shipments of the same product. For the full setup walkthrough, see How to Set Up a Replacement Upsell for Subscriptions.Subscription Upgrades
Subscription Upgrade is the feature that modifies a customer’s existing subscription after checkout. Use it to change the delivery frequency, swap to a different subscription product, or both at the same time. The change is applied directly in Recharge, Skio, or Loop. It is a separate feature from Subscription Upsell because Shopify blocks adding a new subscription to an order that already contains one. For the full setup guide, see Subscription Upgrades.Trigger configuration for subscription upsells
Triggers control when your subscription upsell offer fires. The two most relevant for Subscription Upsell are:- Product trigger. Set this to the original one-time product the customer should have bought for the subscription upsell to make sense. Without a product trigger, the offer can fire on unrelated orders.
- Subscription trigger. Set this to do not include a subscription so the offer only shows to customers whose orders do not already contain a subscription. This avoids the Shopify “one subscription per order” rule kicking the offer out at runtime.
Shopify platform limitations
A few Shopify platform rules apply to subscription-related post-purchase offers regardless of which Aftersell feature you use.One subscription per order
Shopify does not allow a post-purchase upsell to add a subscription to an order that already contains a subscription. This restriction is set by Shopify and applies to all post-purchase apps. If the original order already includes a subscription, you cannot add another subscription post-purchase. Subscription Upsell is only available when the original order contains no subscription items. For orders that already contain a subscription, use Subscription Upgrade instead, which modifies the existing subscription rather than adding a new one. Aftersell handles the “subscription already in cart” case automatically in two ways:- Subscription-only products in an offer are dropped from the funnel for that customer.
- Dual-mode products (configured as one-time + subscription) are auto-downgraded to one-time-only, so the offer still shows but without the subscription option.
Subscription-only products
If a product in your offer is configured to sell only as a subscription (no one-time purchase option), the offer will be skipped whenever the customer’s order already contains a subscription product. When this happens, the funnel editor shows a Subscription limitations warning banner listing the affected products. The banner includes a tip: set the Subscription trigger to do not include a subscription so the offer only shows to customers whose orders do not already have a subscription.Multiple subscription offers in the same funnel
If more than one offer in your funnel contains a subscription product, only the first accepted subscription is added to the order. Subsequent subscription offers are skipped. The funnel editor warns you when this conflict is detected, listing the other offers in the funnel that also contain subscription products. To avoid skipped offers, limit your funnel to one subscription offer, or use the Subscription trigger to exclude orders that already contain a subscription.Testing a Subscription Upsell
Before going live with a new Subscription Upsell offer:Place a real test order in Shopify
Accept the upsell on the post-purchase page
Check Shopify
Check your subscription provider
Troubleshooting
The subscription option is not showing up in my offer editor
The subscription option is not showing up in my offer editor
How does Aftersell pick which selling plan to show?
How does Aftersell pick which selling plan to show?
Can the customer pick their delivery frequency on the post-purchase offer?
Can the customer pick their delivery frequency on the post-purchase offer?
I want to show this subscription-enabled product as one-time only
I want to show this subscription-enabled product as one-time only
My customer accepted the subscription upsell but the subscription is not in my subscription app
My customer accepted the subscription upsell but the subscription is not in my subscription app
- Subscription app webhook is failing. Any subscription app that picks up new subscriptions from Shopify relies on Shopify webhooks. Check webhook delivery health in your subscription app’s logs.
- Selling plan was unlinked from the product but still has an active ID. Shopify accepts the changeset and the line item lands, but the subscription provider has no record to act on.
- Confirm the selling plan is still active in Shopify and assigned to the product.
- Check your subscription app’s order import / webhook logs for the affected order.
- If the subscription is truly missing, your subscription app’s support team can usually manually enroll the customer from the order ID.
The CTA button shows the recurring price instead of the first-cycle discount
The CTA button shows the recurring price instead of the first-cycle discount
My customer's order was charged without the subscription discount on the second cycle
My customer's order was charged without the subscription discount on the second cycle
The offer is showing on orders that already contain a subscription
The offer is showing on orders that already contain a subscription
Only one of my subscription offers is firing in the funnel
Only one of my subscription offers is firing in the funnel
The customer cannot find the subscription in their account
The customer cannot find the subscription in their account
I want to refund or cancel the new subscription after the customer accepted
I want to refund or cancel the new subscription after the customer accepted