Before you begin
Shopify Plus is required for checkout app blocks and One-Click Upsell on production stores.
You need permission to edit and save the relevant Shopify checkout profile.
Create the strategy before testing its placement.
Checkout Page extensions
In Apps > Order Editing > Upsells, open the setup action for the placement. In Shopify's Checkout Editor, add and save the matching block:
Placement | Shopify app block |
|---|---|
Product List Upsell | Product List Upsell |
Checkbox Upsell | Checkbox Upsell |
Free Shipping Upsell | Upgrade to Free Shipping in the Delivery area |
You can also add Remove Product Upsells to the order summary when customers should be able to remove an accepted Product List offer there. Checkbox Upsell already lets customers tick to add and untick to remove its product.
One-Click Upsell
Open Shopify's checkout settings and select Order Editing as the post-purchase app. Only one app can own Shopify's post-purchase page. Save the setting, then return to Order Editing and check the placement status.
Thank You and Order Status extensions
Use Shopify's Checkout Editor to add the main Order Editing block for product carousels. Standalone Product List Upsell and Featured Product Upsell placements need their own matching app blocks.
Lock a strategy to one block
Open the strategy.
Enable Only show this strategy when an app block requests it by ID.
Copy the strategy ID.
Open the intended app block in Shopify's Checkout Editor.
Paste the ID into Locked Strategy and save.
The locked strategy is excluded from normal matching and appears only when a supported block requests that ID.
Recently Viewed needs a separate theme embed
The Recently Viewed product module also needs the Order Editing - Pixel app embed enabled and saved in your Shopify theme. A checkout app block does not replace that storefront embed.
After enabling it, return to the module and refresh its integration status. Check with a visitor who has viewed an eligible product; a visitor with no browsing history can correctly receive no Recently Viewed recommendation.
Install a line-item highlight placement
Choose the intended highlight placement in the strategy, add at least one source under What to highlight, and save. Use that placement's setup action to add its matching app block in Shopify's editor. Confirm the page and position before saving the checkout configuration.
A product-offer block does not automatically install a highlight block. Check a qualifying item with the source data required by your highlight.
Verify installation
Return to Order Editing and confirm the placement shows as installed. Use Shopify's Checkout Editor to verify block position and layout. For Checkout Page behaviour, add a product to the cart and continue to checkout without placing an order.