# 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.

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

* **Sort random the product list:** check or uncheck to show product list sort random.

## VISIBLE IN CART POPUP

* **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

* **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

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

## PRODUCT ITEM SETTINGS

* Please refer to [this guide](/tips.md#product-item-settings) for more details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vodoma-docs.boostheme.com/theme-settings/upsell-products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.