The product block exists within a number of Upsell.com widgets. [Please note that some minor differences may exist between certain pages and specific widgets.]

This guide will focus solely on where there is only one product to display. If you are in a widget, such as the product recommendations widget, which allows you to select multiple products, please follow the guidance here within the product recommendations widget, as it differs from the guidance here.

Other blocks within widgets

You can learn more about other blocks within a widget by clicking the links below. [Please note that some minor differences may exist between certain pages and widgets.]

• Image
• Product details
• Product description
• Price & discount
• Accept button
• Variant picker
• Quantity selector
• Success/Error banner

Customizing the product block

1. Once you are within a widget, click on the Product block

   
   

   
   

2. To add more product blocks to an existing widget, click Add widget

   
   

   
   

3. Select the Product block from the widget selector, and it will be added to the bottom of the widget you are currently in

   
   

   
   

In this article, we will focus on the Product Block. The product block determines which product (or products, depending on the widget) will be displayed to your customers.

Product to display

Within this block, you have the choice to display:-

• Shopify recommendations / complementary products
• A specific product
• A custom product that you create in the Upsell.com editor
• The most expensive product in the customer's order
• The cheapest product in the customer's order
• A number of integrations with third party applications

Each will be discussed below.

Shopify recommendations setup

To set up the product block with Shopify recommendations, follow these steps.

Related recommendations

To set up the Shopify recommendations in accordance with Shopify's algorithm:-

1. Click on Product

2. Select Shopify Recommendations

3. Choose Related Recommendations

4. Related recommendations are auto-generated and can be configured via the Shopify Search & Discovery app

5. Use exclusion tags to exclude products you don’t want to show. For example, tag products as "purple skis"

6. Check or uncheck whether to hide products that are already in the customer's order

Complementary recommendations setup

To set up the Shopify recommendations in accordance with your own settings (note:- these complementary product lists will need to be set up manually via the Shopify Search and Discovery app):-

1. Select Complementary Recommendations

2. Use exclusion tags as needed to exclude products you don’t want to show. In this example we will exclude, "bestsellers." Type 'bestsellers' into the text box

Specific product setup

You can choose to display a specific product. To select a specific product:-

1. Select specific product

2. Click on select featured product / change

3. Select the product you want to display

4. Click on Select.

Note: Unlisted products can be used in Upsell.com offers on every offer page, including post-purchase, checkout and thank you. They stay hidden from your
storefront search, collections and recommendations, but shoppers can accept them in your offers. Draft products can't be used in offers.

There are some further options for customizations on what to do if the specific item you intend to upsell is already in the customer's order.

5. Decide what to do if the specific product you are upselling is already in the customer's order:

• You can choose to display the featured product anyway

• You can hide the upsell

• You can use a Shopify recommendation instead of the product already in the customer's order

• You can display an alternative specific product

Select the alternative product you wish to display if the original product is already in the customer's order. Once you’ve chosen the alternative product, simply click on the Select button to finalize the choice. This step ensures the customer is shown the alternative product instead of the one already in their cart.

Custom product setup

You can create a product for your offer right from the Upsell.com editor. Upsell.com creates it in your Shopify store as an unlisted product, so it shows in your offer, but shoppers won't find it in your storefront catalog, search, collections, or recommendations.

The Custom product option is available in the Product Upsell, Product Recommendations, and Bundle widgets, on every page.

To create a custom product:

1. Click the Product block in your Product Upsell or Bundle widget (in Product Recommendations, click the Products block).
2. Under Product to display, select Custom product.
3. Under Create custom product, click New. The New custom product modal opens.
4. Enter a Title, upload an Image, and set a Price. All three are required. Save stays disabled until an image is uploaded.
5. Optionally, add a Description and a Compare-at price. Leave Compare-at price at 0 to show no compare-at price.
6. Leave Physical product on if the product requires shipping. It is on by default.
7. Click Save.

Note: The first time you save a custom product, Shopify may ask you to update the app's data access (View and edit store data / Publications of products on sales channels). Approve the prompt so Upsell.com can create the unlisted product.

Edit or remove a custom product

Your custom product appears under Create custom product, with Edit and Delete.

• Click Edit to change the title, description, image, price, compare-at price, or physical product setting. Saving updates the product in Shopify.
• Click Delete to remove the custom product from the widget. The product stays in your Shopify store.

How custom products stay in sync with Shopify

Shopify is the source of truth for your custom products:

• Changes you make to the product in Shopify show up in your widget automatically.
• Upsell.com never changes the product's inventory, tags, SEO, or extra variants.
• If the product is deleted in Shopify, the editor shows a banner that says This product was deleted in Shopify. On your storefront, the widget is hidden (or that product is skipped in multi-product widgets), so shoppers never see a broken offer. Click Edit, fill in the fields, and save to create a replacement unlisted product for the widget.

Most expensive product in cart

1. Select Most expensive product in the order

2. Add exclusion tags if you wish as above

Cheapest product in cart

1. Select Cheapest product in the order

2. Add **exclusion tags **if you wish as above

Using an integration of Recomatic

Recomatic recommendations

The Recomatic recommendations integration helps ensure customers see products they are likely to be interested in based on the data available. More details can be found by clicking the link to the integration.

Tips

• Use Custom product for an item that exists only for your offers. It stays unlisted, so shoppers only see it in your offers.
• To update a custom product beyond the fields in the editor, open it in your Shopify admin. Your changes show up in the widget automatically.
• Deleting a custom product from a widget doesn't delete it from Shopify. If you delete it in Shopify instead, the editor shows This product was deleted in Shopify, and the offer is hidden on your storefront until you create a replacement from Edit.

Well, that’s a wrap!

If this article did not solve your issue, our support team is available for you 24/7, just click the live chat button at the bottom-right corner of this page.

Updated on: 26/10/2026