# Upsell products

## Add Upsell tags to certain products

Our themes use product tags as "upsell tags" to set up upsell. An upsell tag must be a handle string(only allow letters, "**-", "\_"**, no space, no special characters) and have the syntax: **"upsell\_"**. Refer to [**here**](https://shopify.dev/docs/themes/liquid/reference/filters/string-filters#handle-handleize) for more details about the handle string. When users view a product page, products have **at least one upsell tag that is identical to the current viewing product's upsell tags** will be displayed as upsell products. A product is able to have many upsell tags.

Example: product A has the upsell tags are **upsell\_fashion, upsell\_clothing**. When users view this product on the product page. Products have tags **upsell\_fashion** or **upsell\_clothing** will be shown as upsell products.

Upsell products are also shown in the popup cart after a product has been added to the cart.

## Open Upsell products settings. <a href="#open-upsell-products-settings" id="open-upsell-products-settings"></a>

1. From your Shopify admin, go to **Online Store** > **Themes**.
2. Find the theme that you want to edit and click **Customize**.
3. In the left-hand toolbar, click **Theme settings.**
4. Click **Upsell products.**

## GENERAL SETTINGS <a href="#general-settings" id="general-settings"></a>

* **Sort random the product list:** check or uncheck to show product list sort random.
* **Enable:** check or uncheck to enable upsell in cart popup
* **Limit:** drag and drop to choose product quantity that displayed in cart popup

## VISIBLE ON PRODUCT PAGE <a href="#visible-on-product-page" id="visible-on-product-page"></a>

* **Enable:** check or uncheck to enable upsell in the product page
* **Limit:** drag and drop to choose product quantity that displayed

## VISIBLE ON CART PAGE <a href="#visible-on-cart-page" id="visible-on-cart-page"></a>

* **Enable:** check or uncheck to enable upsell in the cart page
* **Limit:** drag and drop to choose product quantity that displayed

## PRODUCT ITEM SETTINGS <a href="#product-item-settings" id="product-item-settings"></a>

* Please refer to [this guide](https://beloria-docs.boostheme.com/tips#product-item-settings) for more details.
