For the complete documentation index, see llms.txt. This page is also available as Markdown.

Product upsells

Suggest add-on products on your product page, using the complementary products you choose in Shopify's Search & Discovery app.


The Product upsells block shows a short list of add-on products under a heading such as "Frequently bought together". Each row has the product image, title and price, plus a button. It suits accessories and refills that go well with the product being viewed, for example a case for a phone or a strap for a watch.

The products come from the complementary products you set for each product in Shopify's free Search & Discovery app. If a product has no complementary products, the block doesn't show on that product's page.

1. Our guide to set up a Product upsells block:

Steps:

  • In the theme editor, open a product page using the page selector at the top.

  • In the Product information section, click Add block.

  • Select Product upsells.

  • Click Save.

2. Choose complementary products

Steps:

  • In your Shopify admin, install the Search & Discovery app if you don't have it yet.

  • Go to Apps > Search & Discovery and click Product recommendations.

  • Click Add recommendations and select the product you want to add upsells to.

  • Under Complementary products, select the products to suggest.

  • Click Save.

Repeat this for each product that should show upsells. Complementary products must be active, published to your Online Store and in stock to appear. See Shopify's guide: Customize product recommendations with Search & Discovery.

3. Block settings

  • Heading: The title above the products, for example "Frequently bought together".

  • Maximum products to show: How many complementary products to list, 1–8.

  • Enable quick add button: Changes the button on each product:

    • Off: a Buy now button that opens the product page.

    • On, product with one variant: an Add to cart button that adds it straight to the cart. It shows Sold out when that product is out of stock.

    • On, product with several variants: a View options button that opens a quick view so shoppers can choose a variant.

  • Block style

    • Collapsible: Turns the block into a collapsible tab that shoppers click to open.

    • Layout: Compact / Boxed. Boxed puts the tab in a bordered box. Only applies when Collapsible is on.

    • Open by default: Shows the collapsible tab open when the page loads. Only applies when Collapsible is on.

4. Tips

  • Pick lower-priced add-ons that genuinely go with the product. They are the easiest extra purchase.

  • Turn on Enable quick add button so shoppers can add upsells without leaving the page.

  • If the block shows nothing in the theme editor, preview a product that has complementary products set in Search & Discovery.

  • You can add one Product upsells block per product template. For a bundle with one combined add to cart button, see Bought together.