Skip to main content
The Upsells module enables customers to add related or complementary products to their cart with a single click. Image

​
Product Selection

Enable this setting to use Shopify’s Product Recommendation Algorithm to suggest upsells automatically.

​
Recommendation Algorithm

This option appears only if AI recommendations are enabled. Choose your desired Recommendation Intent: Recommendation Intent: Displays similar or substitutable products under a “You might also like” section.
  • Important: Products must share a collection to be considered “related.”

​
Complementary products

Displays add-ons or accessories under a “Pair it with” section.

​
Smart Variant Matching

When enabled, Upcart uses AI to automatically pre-select a variant on an upsell product that matches what the customer already has in their cart, rather than defaulting to the first variant in the list. For example, if a customer adds a black shirt to their cart, the upsell will automatically pre-select the black variant on a paired pants product. If they added a blue shirt instead, the blue variant would be pre-selected instead. Smart variant matching works even when option names aren’t identical across products. If no matching variant is found, the customer can still select one manually.

​
Manual Upsells Configuration

Manual upsells can be set up only when AI Recommended Upsells is disabled. Click Configure Manual Upsells. Image Click Add New Upsell to add a row with:
  1. Trigger Product(s)
    Specific Trigger: Choose at least one product that must be in the cart.
    All Products: Display the upsell when any product is in the cart.
  2. Upsell Product(s)
    Select the product(s) to show when a trigger product is in the cart.
Image

​
Order of Upsell Appearance

Upsells are evaluated from top to bottom. To arrange the priority of rows, drag and drop them in the Cart Editor under the Configure Manual Upsells section. The system displays upsells based on their top-to-bottom arrangement in the Cart Editor. Image If Products A and C are in the cart, and you’ve set upsells for each, both B and D will be shown. When selecting multiple upsell products in a single upsell row, the order of product selection will determine the order of their appearance in the cart, top to bottom.

​
Displaying Reviews

Upcart can display product reviews on upsells and product recommendations to help customers make informed purchase decisions. Reviews are not shown on standard cart line items. Upcart uses the **Shopify Storefront API**to read review data stored in product metafields. Because of this, reviews will only appear if your review app exposes product review data in a format the Storefront API can access. Image

​
Supported review apps

At this time, Upcart supports reviews from the following apps: Only these apps are officially supported, as they store review data in compatible product metafields. If reviews aren’t appearing, make sure you’re using one of the supported apps and that the products shown in upsells or recommendations have reviews available.

​
Troubleshooting

If your upsell isn’t displaying, check out the “Why Isn’t My Upsell Showing?” article in our FAQ for common fixes.

​
Next Steps

To fine-tune how upsells behave in the cart drawer, continue to the next guide: Upsell Module: Settings