How to Add Upsells to Shopify Checkout, Thank You & Order Status Pages
What you will achieve in this guide
Follow the feature-specific setup and testing instructions below. Check the supported pages and plan requirements before activating the feature.
Upsell campaigns recommend products during checkout or on the Thank you and Order status pages.
How this feature works
A trigger product determines who qualifies for an offer; the offer product is the recommendation the buyer can purchase. Configure the campaign in Rivio and place its matching block on the intended Shopify page. Checkout, Thank you, and Order status are separate surfaces with separate testing flows.
Before you begin
Open Apps > Rivio Checkout Customizer in the intended store. Prepare the cart, customer, products, address, or order needed by the example, and check the feature’s supported inputs before activating it.
Worked example: Offer a Bottle when a buyer purchases a T-shirt
Example setup: Demo T-shirt as the trigger; Demo Bottle $20 as the offer; an eligible store and target page.
Step-by-step instructions
Choose the target surface first. Open Checkout upsell for a Plus checkout-step offer, or Thank you / Order status upsell for a supported post-checkout offer.
Create a campaign named T-shirt to Bottle. Under Trigger conditions choose Specific products and select Demo T-shirt.
Under Upsell products choose Specific products and add Demo Bottle. These are different selections: buying the shirt qualifies the buyer; the bottle is the recommendation.
Set a supported Offer incentive to 10% and review whether Apply discount on each item is enabled. For a single $20 bottle, the illustrative offer reduction is $2.
Enter Complete your kit as the headline. Review multiple quantities, hide-already-in-cart, and hide-widget-after-add options shown for this surface.
Set the intended Show on page, a distinct Priority such as 0, and Active status; save.
Add the matching upsell block on that exact page in Shopify’s editor and save. Checkout-step offers require Plus.
For checkout, start with the shirt in the cart. For Thank you, complete a shirt order. For Order status, revisit that completed order and follow the offer’s displayed purchase action.
Verify the result
| Test case | Expected result or verification |
|---|---|
| Trigger shirt present and offer bottle absent | The eligible active campaign displays on its placed surface. |
| Cart/order without the shirt | This specific-product campaign does not qualify. |
| Bottle already present with hide-already-in-cart enabled | The offer can intentionally be hidden. |
| Accepted post-checkout offer | Follow its checkout flow and verify the resulting purchase; do not assume it edits or recharges the original paid order. |
Important: For conditional-offer demonstrations, add one supported condition at a time and compare a matching and non-matching buyer. The lowest Priority number wins between matching campaigns.
If the result is different
| Check | What it means / what to do |
|---|---|
| Nothing appears | Check campaign/rule status, target surface, trigger inputs, available products, and saved editor placement. |
| A different offer appears | Inspect matching campaigns; the lowest Priority number takes precedence. |
| An offer disappears after adding an item | Check hide-already-added and hide-after-acceptance behavior before creating a duplicate campaign. |
Related guides
- Understanding Checkout, Thank You & Order Status Customizations
- How to Add an Upsell to the Shopify Thank You Page
- How to Add an Upsell to the Shopify Order Status Page
Need help?
Email support@rivioapps.com with your store domain, feature name, target page, the relevant settings, and a screenshot of the actual result. Include the test cart, customer, or order details needed to reproduce the issue.
Screenshot reference
Screenshot to add: The saved settings described in this guide, with its selected conditions or scope visible.
Screenshot to add: The worked example’s actual customer result or saved Shopify record, including the relevant test inputs.
Was this article helpful?
Your feedback helps us continuously improve our setup guides and documentation.
Thank you for your feedback! Our documentation team reviews all suggestions.