Understanding How Vitals Upsell Offers Now Work with Shopify Functions
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.
Shopify’s Automatic Discount Limit (25 Maximum)
Shopify currently allows a maximum of 25 active automatic discounts per store.
Because each upsell offer in Vitals now corresponds to one automatic discount, this limit affects how many upsell offers you can create.
For example:
- If you already have 10 automatic discounts in Shopify, you can create up to 15 Vitals upsell offers.
- If you have no other automatic discounts, you can create up to 25 upsell offers.
🛈 For more details, see Shopify’s official documentation:
Shopify Help: Automatic Discounts
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
Gift offer eligibility depends on how the offer was created:
- If “Any Product” is selected as eligible products:
- The offer checks the final cart total after all other upsell discounts are applied.
- If the total meets or exceeds the requirement, the gift offer becomes active.
- If specific products are selected as eligible products:
- The offer checks the gross order total before other discounts.
- The offer becomes active once that total meets the gift offer’s requirement.
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 also observe the cart total after other upsell discounts are applied.
- This ensures that the discount logic aligns correctly with Shopify’s native checkout calculations.
Summary of Key Considerations
| Factor | Behavior |
|---|---|
| Shopify Discount Limit | Maximum of 25 active automatic discounts (including upsell offers). |
| Gift Upsell Activation | Gift is free only when the spending threshold is reached. |
| Spending Goal Calculation | Uses post-discount cart total. |
| Gift Offer (Any Product) | Observes cart total after other discounts. |
| Gift Offer (Specific Products) | Observes gross total before discounts. |
Why This Change Matters
Migrating to Shopify Functions makes your upsell offers:
- Faster: Discounts are calculated natively in Shopify.
- More reliable: No conflicts with other discount apps.
- 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.
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.