Setup
1
Add the checkout block
In the checkout editor (Settings → Checkout → Customize), on the
Checkout page, add the app’s checkout upsell block — for
example below the order summary — and save. See
Installation & setup.
2
Create the upsell
Go to Upsells → Create upsell and configure the three wizard
steps below. The Checkout Upsell trigger carries a
Shopify Plus badge in the wizard.
Step 1 — Trigger
Under Select Upsell Trigger, choose Checkout Upsell, then define when the offer shows: Give the upsell a name under Name this offer for your own reference — customers never see it.Customer orders (product scope)
Under Show Upsell offer when → Customer orders, choose:- Any products — the offer can show for every order
- Specific products — only when the order contains at least one of the selected products
- Specific collections — only when the order contains a product from the selected collections
- Excluded products — only when the order contains none of the selected products
Conditions
Click Add condition to add fine-grained requirements. Conditions are grouped into Products, Orders, and Shipping:
Conditions combine with AND / OR — switch the connector between
rows to require all conditions or any of them.
Click Save (Next Step) to continue to the Offer step.
Step 2 — Offer
Click Select products and pick one or more products to offer — customers can choose variants on the offer itself. Options for the product list:- Exclude products already in customer’s order — buyers are never offered something they just bought
- Use custom discount title — sets the discount name that appears on the order and receipts
- Use compare at price — shows the compare-at price as the strikethrough reference instead of the regular price
Product discounts
Each product carries its own discount:Discount values must be whole numbers (no decimals), percentages
must be between 1 and 100, and amount/specific values can’t exceed the
product’s original price. Discounts apply automatically — there are no
codes for customers to enter.
Shipping discounts
This placement also supports shipping discounts on the offered product:
Each option supports an optional Shipping message shown on the offer —
e.g. “Free Shipping!” or “50% off shipping”. Leave it blank to use the
default wording.
Funnel: Upsell #2 & downsell
Still in the Offer step, you can chain the primary offer into a small funnel:- Upsell offer #2 — shown if the customer accepts the first offer
- Downsell offer — shown if the customer declines the first offer
The downsell only shows after an explicit decline of the first
offer — if the countdown timer expires or the customer navigates away,
the funnel ends without a downsell.
Step 3 — Style
The final wizard step controls everything the customer sees — message banner and countdown timer, product card layout and color scheme, CTA and decline text, text block, and image — with a live preview per funnel step. Finish with Save and publish.Styling has its own guide: Styling your
offer covers every
section, the custom labels, and the
SAVE badge — and Translations &
languages shows how
to localize the offer text for shoppers in 11 languages.Styling your offer
Layouts, color schemes, timer, custom labels, and images.
Translations & languages
Localize offer text; manage default and additional languages.
Use cases & examples
Last-chance add-on under the order summary
A small, universally useful product at a modest discount.
Last-chance add-on under the order summary
A small, universally useful product at a modest discount.
Offer a small, universally useful product (gift wrap, a sample set)
to every checkout with a modest discount — classic impulse placement.
Free-shipping threshold nudge
Help carts under $50 reach your free-shipping threshold.
Free-shipping threshold nudge
Help carts under $50 reach your free-shipping threshold.
Combine a trigger condition Order subtotal → Lesser than → 50
with an attractively priced add-on to help customers reach your
free-shipping threshold before they place the order.
Troubleshooting
The block isn't available or doesn't render
The block isn't available or doesn't render
- Checkout UI blocks require Shopify Plus — on other plans the block can’t be placed in the checkout editor.
- The block must be manually added on the Checkout page in the checkout editor and saved.
The offer doesn't show during checkout
The offer doesn't show during checkout
Confirm the upsell’s trigger is Checkout Upsell, its status is
Active, and its conditions match the cart you’re testing with —
subtotal excludes tax/shipping, total includes them. Only the
highest-priority matching checkout upsell is shown — see
Managing upsells & priority.
The discount didn't apply to the added item
The discount didn't apply to the added item
The app’s discount function applies offer discounts automatically —
re-save the upsell to re-sync it. Check the whole-number and range
rules on the discount value.
Need help?
Book a call
Schedule a free call with our team for personal setup assistance.
Contact support
Chat with us directly — we’re happy to help with any question.
Install Yuko Post Purchase Upsells
Get Yuko Post Purchase Upsells from the Shopify App Store.