Skip to main content

Choosing Which Products to Show

Pick the products that appear in an upsell — hand-pick a list, use Shopify's automatic recommendations, or pull from your Search & Discovery pairings.

Written by Tom Nipravsky

Every upsell needs a product source — the rule that decides which products appear inside the offer. You have three options, and each one fits a different style of merchandising. The setting is per-upsell, so different upsells can use different sources.

Option 1 — Manual selection

You hand-pick the products you want to show. Up to 20 products per upsell.

This is the most control: you decide exactly which items appear, in exactly the order you want, with the exact variants you want featured.

How it works

  1. In the upsell form, set Product source to Manual selection.

  2. Click the picker to add products from your catalog. You can add up to 20.

  3. (Optional) For each product, pin specific variants — for example, only show the Medium and Large sizes, not the full range.

  4. Drag the selected products to reorder them. The customer sees them in the order you set.

  5. Save.

Variant pinning

For each product you add, you can either:

  • Leave variants empty — the product's default variant is shown to the customer. The variant selector still appears at checkout if there are alternative variants available.

  • Pin specific variants — only the variants you pin are offered to the customer.

Variant pinning is useful when:

  • You only want to surface in-season sizes

  • A product has many variants but only a few are upsell-worthy

  • You want the customer to choose between, say, "Black" and "Navy" without scrolling through eight other colours

Option 2 — Related items

Shopify maintains an automatic "Customers also bought" recommendations engine for every product in your store. With Related items, you delegate product selection to that engine — no curation required.

How it works

  1. In the upsell form, set Product source to Related items.

  2. Set Maximum number of products to show (between 1 and 10).

  3. Save.

That's it. At runtime, Shopify picks the related items for the cart's anchor product and the upsell shows up to the maximum number you set.

What "anchor product" means

The recommendations are anchored on the product that's currently in the cart (for Checkout upsells) or the order (for Order-editing upsells). Different anchors produce different recommendations — the customer will see different items depending on what they bought.

Note: Shopify's recommendations engine returns at most 10 items, and the same anchor returns the same items consistently. If a particular anchor has no recommendations available, the upsell won't render for that customer.

Option 3 — Complementary products

Pulls from the pairings you've configured in Shopify's Search & Discovery app under "Complementary products". This is the merchant-curated equivalent of Related items: you've already told Shopify which products go together (e.g. "this phone case pairs with this phone"), and the upsell uses those pairings.

How it works

  1. In Shopify admin, install the Search & Discovery app and configure complementary product pairings for the products you want to upsell from.

  2. In the Triom upsell form, set Product source to Complementary products.

  3. Set Maximum number of products to show (between 1 and 10).

  4. Save.

When to pick Complementary products

  • You already manage cross-sell relationships in Search & Discovery

  • You want intentional pairings (not algorithmic recommendations)

  • You sell products with strong "X always goes with Y" relationships — phone + case, lens + lens cap, dress + matching belt

  • You want the same merchandising logic across your storefront and your upsells

Important: If you haven't configured complementary pairings in Search & Discovery for the cart's anchor product, no upsell will be shown for that customer. The source returns nothing rather than falling back to a default. If you start with this source, plan to set up pairings for your top products before launching.

A note on Order-editing upsells

For Order-editing upsells, the source applies to both surfaces (Thank You and Order Status) — you can't pick a different source per surface from a single upsell. If you want different source logic on each surface, create two upsells (one per surface) and use the Upsell ID pinning model described in Upsells in the Order-Editing Flow.

What's next

Did this answer your question?