An Order-editing upsell appears after the customer pays — inside the same Edit your order experience that lets them change quantities, swap variants, or update an address. It turns the post-purchase moment into a chance to add more products to an order that's already paid for. If the addition pushes the total up, the customer is prompted to pay the difference.
This is the cross-feature article: it ties the Upsells section in your admin together with the Order Editing experience that's already running on your store. If you haven't set up Order Editing yet, start with Getting Started with Order Editing — Order Editing is what hosts the upsell.
What customers see
There are two surfaces where an Order-editing upsell can show:
On the Thank You page
The Thank You page is what customers see immediately after checkout. The upsell appears as a small section labelled Complete your order (or your custom heading), with one or more product cards.
When a customer adds an upsell product on the Thank You page and the addition creates outstanding payment, a green banner appears under the offer with a View invoice and complete payment link, taking them to a Shopify-hosted invoice to pay the difference.
On the Order Status page
The Order Status page is the post-purchase page customers can revisit any time via the link in their order-confirmation email. The upsell row appears below the editing actions (change address, change quantity, etc.).
Because the Order Status page is hosted inside the customer's account, customers see a normal toast confirmation when they add an upsell — they don't need a separate payment banner there.
Two prerequisites before any upsell will show
Before an Order-editing upsell can appear to a customer, two things have to be in place — both of them on the Order Editing side, not the Upsells side:
1. The Order Editing app block has to be installed on that page
Order-editing upsells are rendered inside the existing Order Editing app block. If the block isn't installed on the Thank You or Order Status page, no upsell will appear there — even if the rest of your configuration is perfect.
If you haven't installed the blocks yet, follow Adding Order Editing Blocks to Your Thank You and Order Status Pages. Order Editing has to be installed first; the upsell rides on top of it.
2. The "Upsell products" allowed-action toggle has to be on
Order Editing has a master toggle for upsells. Open your Order Editing settings, go to Allowed actions, and turn on Upsell products. Without this toggle, no Order-editing upsell will appear regardless of how it's configured.
Important: This toggle ships off by default so existing stores aren't surprised by a new section appearing. Turn it on once you've created an Order-editing upsell. See Choosing Which Changes Customers Can Make for the full list of toggles.
Creating an Order-editing upsell
Open the Triom app and go to Upsells.
Click Create upsell.
Choose Order editing as the type.
Fill in the form section by section (see below).
Save in Draft to preview, then click Activate when you're ready to go live.
(If you haven't already) turn on Upsell products in Order Editing → Allowed actions.
Section: Basics
Name — internal label for your dashboard. Keep it descriptive (e.g. "Post-purchase add-on for full-price orders").
Status — start in Draft while you configure. Switch to Active when you're ready.
Section: Surfaces
This section is unique to Order-editing upsells. It's where you pick which post-purchase pages the upsell shows on.
You'll see two toggles:
Thank you page — show this upsell on the Thank You page right after checkout.
Order status page — show this upsell on the Order Status page (the one customers return to from their order-confirmation email).
At least one of the two must be on. You can have both on (the same upsell appears in both places), only one (the upsell is scoped to a single surface), or use the pinning model below to run different upsells on each surface.
Section: Filters
Decide who sees this upsell. The default is Show to all customers. To target specific scenarios, switch to Match conditions.
The filter system is shared with Checkout upsells and has its own article: Choosing Who Sees an Upsell.
Note: When the customer adds a product to their order during an edit and then removes it, the removed product doesn't count as "in the order" for filter purposes. Filters always evaluate the live state of the order.
Section: Product source
Three options, the same as for Checkout upsells:
Manual selection — hand-pick the products you want to suggest.
Related items — let Shopify auto-pick "Customers also bought" recommendations based on what the customer just ordered.
Complementary products — pull from pairings configured in Shopify's Search & Discovery app.
See Choosing Which Products to Show for guidance on which to pick.
Section: Discount (optional)
Optionally apply a discount to the upsell when it's accepted.
Percentage off the upsell product (e.g. 10% off)
Fixed amount off the upsell product (e.g. $5 off)
Discount message — the label shown on the order's discount line (e.g. "Upsell 10% off").
Note: Free-shipping discounts are not available for Order-editing upsells (only for Checkout). Order-editing discounts only adjust the upsell product's price; the original order's shipping isn't recalculated.
Section: Settings
Two knobs:
Allow customer to add multiple quantities
When on, each offer card shows a quantity stepper so customers can add more than one. Useful for consumables and accessory items.
Hide products already in the order
When on, any product whose default variant is already on the order is filtered out — so you don't suggest something the customer already bought. Recommended on.
Pinning a specific upsell to a surface
By default, when several Order-editing upsells are active, the app picks the first matching upsell for the surface a customer is looking at. That's the right behaviour when you only run one upsell, or when you're happy with auto-rotation.
If you want different upsells on different surfaces — e.g. one upsell on the Thank You page and a completely different one on the Order Status page — you can pin a specific upsell to a specific app block.
Where the Upsell ID lives
When you add the Order Editing app block to a page in the Shopify checkout & accounts editor, the right-hand settings panel shows an optional Upsell ID field.
Leave it blank (default) — the app picks the first matching active Order-editing upsell whose surface toggle is on for that page.
Paste a specific upsell's ID — only that upsell is considered for this block. If it doesn't match the order's filters, nothing is shown (the app does not fall back to other upsells).
Where to find an upsell's ID
In the Triom app, go to Upsells and open the upsell you want to pin.
The Upsell ID appears as a section in the right-hand aside. Click the copy button to copy the UUID.
Paste it into the Upsell ID field on the app block in the Shopify editor and click Save.
Common pinning scenarios
Different upsell on Thank You vs Order Status — create two Order-editing upsells, pin one's ID to the Thank You page block and the other's to the Order Status block. Each upsell can have a different product source, filters, and discount.
Tip: Pinning is per-block-instance, set in the Shopify checkout & accounts editor. The toggles inside the upsell itself (Surfaces → Thank You / Order status) still apply: a pinned upsell with Thank You page turned off won't render on the Thank You block even if its ID is pasted there.
When the upsell isn't shown
If you're expecting an upsell but it's not appearing, walk through this checklist:
The Order Editing app block isn't installed on the page. See Adding Order Editing Blocks.
Upsell products is off in Order Editing → Allowed actions.
The upsell's status is Draft or Paused.
The relevant Surface toggle (Thank You or Order status) is off on the upsell itself.
The upsell's filters didn't match the order — check the order's subtotal, items, and customer details against your conditions.
All eligible products are already in the order and Hide products already in the order is on.
An Upsell ID is pinned on the block, and either the ID is wrong, or the pinned upsell is paused, or its filters don't match this order.
A different upsell came first (when nothing is pinned, the first matching active upsell wins). Pin a UUID to control which upsell shows.
Best practice picks
Goal | Recommended setup |
Run one universal post-purchase offer | One upsell, both Surface toggles on, no Upsell ID pinned on either block |
Different offers on Thank You vs Order Status | Two upsells (each with the right Surface toggle on), pin each upsell's ID to the matching block |
Test how the surface affects conversion | One upsell with both Surfaces on; compare per-surface views and conversions in analytics |
Reward bigger orders with a complementary item | Filter on cart subtotal |
What's next
Choosing Which Products to Show — manual, related, or complementary
Choosing Who Sees an Upsell — target specific scenarios
Reading Your Upsell Analytics — measure what's working
Choosing Which Changes Customers Can Make — the Upsell products master toggle
Adding Order Editing Blocks to Your Thank You and Order Status Pages — installing the host blocks and the Upsell ID field