Understanding How Vitals Upsell Offers Now Work with Shopify Functions
Last updated on October 21, 2026
As part of Shopify’s ongoing platform improvements, our Vitals Upsell Builder has been upgraded to use Shopify Functions — the new, faster, and more flexible way Shopify apps extend checkout and discount logic.
This update ensures that your upsell offers perform more reliably and integrate seamlessly with Shopify’s native discount system.
What Has Changed
Previously, Vitals handled upsell logic internally within the app.
Now, all upsell offers are calculated and applied via the Shopify Functions API.
What This Means for You
- No change in storefront experience: Your customers will see and interact with upsell offers the same way they always have.
- Improved performance and compatibility: Shopify Functions ensures faster, native discount handling directly within Shopify Checkout.
- New limitations and rules: Since upsells now rely on Shopify’s automatic discounts, some Shopify platform limits apply.
How Upsell Offer Types Work with Shopify Functions
1. Gift Upsell Offers
Gift offers allow you to reward customers with a free product when a specific order condition is met.
Important behavior notes:
- The gift product is only free after the defined order requirement is met.
- If the order total doesn’t meet the requirement, the gift product remains at its regular price.
How Gift Upsells Calculate Order Amounts
The gift becomes free once the products that count toward the offer (all products, or the ones you chose) reach the offer's spending requirement in the cart.
2. Spending Goal Upsell Offers
Spending Goal offers motivate customers to spend more by unlocking discounts when a certain order value is reached.
- These offers use the cart total after product discounts (such as bundles or volume discounts) are applied.
3.Product Bundle and Buy X Get Y upsell offers
Discounts of these offers are applied when the shopper adds the offer through its widget (on the product page, a cart upsell suggestion, or the Add-to-Cart/Checkout pop-up). If the offer's products are added to the cart separately, the discount isn't applied, with one exception: a Buy X Get Y offer with Discount the cheapest item automatically ticked rewards the cheapest qualifying items in the cart however they were added. See Creating BOGO or Buy X Get Y offers.
4. Which discounts can combine
In any offer's discount card, Discount combinations sets which other discounts your Upsell Builder offers can combine with at checkout: product discounts, order discounts and shipping discounts. It applies to all your offers, and all three are on by default.
Summary of Key Considerations
| Factor | Behavior |
|---|---|
| Gift Upsell Activation | Gift is free only when the spending threshold is reached. |
| Spending Goal Calculation | Uses the cart total after product discounts. |
| Product Bundle and Buy X Get Y | Widgets need to be clicked for the discount to apply, except Buy X Get Y offers with Discount the cheapest item automatically ticked. |
Why This Change Matters
Migrating to Shopify Functions makes your upsell offers:
- Faster: Discounts are calculated natively in Shopify.
- More predictable: Shopify applies the discounts itself, following its discount combination rules.
- Future-proof: Built on Shopify’s latest checkout architecture.
You can continue creating upsell offers as before, just with these new Shopify discount limitations in mind.
Restore a Deleted Vitals Automatic Discount
If you delete a [DO NOT DELETE] Vitals Automatic Discount in Shopify Admin, your offers and their settings remain safe in Vitals. However, affected offers can still appear on your storefront while their discount is not applied at checkout.
To restore the discount:
- In Vitals, go to Upsell Builder → Offers and open the Active tab.
- For each affected live offer with a discount, select Save as Draft, then Publish.
- Within a few minutes, a new [DO NOT DELETE] Vitals Automatic Discount entry will appear in Shopify Admin → Discounts.
Publishing an offer restores the discount for its offer group. If you are not sure which offers were affected, it is safe to republish every active offer with a discount. Leave the new [DO NOT DELETE] entries in place and exclude them from future bulk deletions.
Need Help?
If you have questions about how these changes affect your current upsell setup, visit our Vitals Help Center or contact our support team directly in-app — we’re happy to help you make the most of your upsell strategy.