Skip to main content
The Upsells module enables customers to add related or complementary products to their cart with a single click. Cart drawer showing a You'll love these upsell section with Add buttons

​
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. The intent changes which products Shopify returns; it does not change the section heading. However you set it, upsells render under your Upsell title (default “You’ll love these”). Shows similar or substitutable products.
  • Important: Products must share a collection to be considered “related.”

​
Complementary products

Shows add-ons or accessories.

​
Smart Variant Matching

This checkbox only appears when Use AI recommended upsells is on and the Recommendation Algorithm is set to Related. It isn’t available for manual upsells or for the Complementary intent.
When enabled, Upcart pre-selects 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. Upsells module with the Configure Manual Upsells button highlighted Click Add New Upsell to add a row with:
  1. Trigger
    Specific Trigger: choose at least one product that must be in the cart.
    Collection: the trigger fires when any cart item belongs to the chosen collection — pick it from the Collection tab of the selection modal.
    All Products: display the upsell when any product is in the cart.
  2. Upsell
    Select the product(s) to show when the trigger matches — or a collection, which pulls its products in.
Configure Manual Upsells dialog with trigger product and upsell product columns

​
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. Manual upsell rows pairing trigger and upsell products with drag handles for ordering 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. Upsell product card displaying a star rating and review count

​
Supported review apps

At this time, Upcart supports reviews from the following apps:
  1. Shopify Product Reviews
    https://apps.shopify.com/product-reviews
  2. Junip
    https://apps.shopify.com/junip
  3. Okendo
    https://apps.shopify.com/okendo-reviews
  4. Growave
    https://apps.shopify.com/growave
  5. Fera
    https://apps.shopify.com/fera
  6. Yotpo
  7. Stamped
  8. Loox
  9. REVIEWS.io
  10. Automizely
  11. Judge.me
  12. Ali Reviews
  13. Trustoo
  14. Rivo
  15. Rivyo
  16. Vitals
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