Looking for the v10 manual? Visit our new user's guide!
Search Descriptions Version
This article applies to: MultiStore


The upsell feature gives store admins the ability to cross-sell or recommend additional products to their customers.


1 - First, list the IDs of the products you would like to upsell (this must be done for each product) on the Manage Products page in the admin site. You can also specify a discount for upsell products if desired. This discount will only be applied if the product is added to the cart through the upsell windown on another product page. Adding that product directly to the cart from its own product page will not apply the discount.

If you don't know the ID's of the products offhand, click on the 'Upsell Products Helper' bar to the right and you'll be shown a search box:

Enter the name of a product you are searching for, and all matching products will be displayed. Check the ones you want, and they will be added to the list of upsell products.

2 - Configure these AppConfigs as desired for your site:

AppConfig NameDescription
UpsellProductsGridColWidthThis controls how many upsell products to display per row.
ShowUpsellProductsOnCartPageIf this is set to true, upsell products will also be displayed on the shopping cart page (based on the products already in the cart).
UpsellProductsLimitNumberOnCartIf ShowUpsellProductsOnCartPage is set to true, this determines how many upsell products to display.


Upsell products configured this way will display at the bottom of product detail pages and the shopping cart:


Upsell products must meet the following criteria or they will not display:

- Cannot have sizes
- Cannot have colors
- Cannot require a text option
- Cannot be kits
- Must be published
- Cannot be deleted
- Cannot already be in the shopping cart
- The default product variant of the Upsell product will be added to the cart
- There is a bug where the Upsell product Price in the cart will be pulled from the variant with the lowest ID number if there are multiple variants on the Upsell product, although the default variant is added: Be sure the lowest variant ID is also the default variant. This was fixed in version 9400+ where the default variant will be correctly added.