> For the complete documentation index, see [llms.txt](https://docs.tipo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tipo.io/tipo-related-products/widget-setup/choosing-recommended-products.md).

# Choosing recommended products

👉 If targeting answers **“Where does the widget show?”**,\
then recommendations answer **“What products do customers see?”**

<figure><img src="/files/0BCy6L3tMAflwjcC72iB" alt=""><figcaption></figcaption></figure>

## ✅ How product recommendations work

Each widget can recommend products in one main way:

* **Manual** – you pick the products
* **Automatic** – the app selects products based on rules

You can change this at any time.

***

## 🛠️ Step 1: Open recommendation settings

1. Go to **the app > click Widgets**
2. Open the widget you want to edit
3. Scroll to **Choose Recommended Products**.

<figure><img src="/files/MvHpuCcvXXURiv8WOHor" alt=""><figcaption></figcaption></figure>

***

### ⚙️ Option 1: Specific products (manual)

You manually choose exactly which products to show.

#### How it works

1. Select **Specific products**
2. Click **Browse**
3. Choose one or more products
4. Save.

<figure><img src="/files/jkTzmu2smvmspxzecfPp" alt=""><figcaption></figcaption></figure>

✅ Best for:

* High-priority products
* Custom bundles
* Marketing campaigns

**Example**\
For a camera product, manually select:

* Camera bag
* Tripod
* Memory card

***

### ⚙️ Option 2: Specific product variants

Similar to manual products, but lets you recommend **specific variants**.

<figure><img src="/files/9zmLDMe4wTWJoWNYaGkK" alt=""><figcaption></figcaption></figure>

Best for:

* Size or color-based upsells
* Variant-specific recommendations

***

### ⚙️ Option 3: Manual Recommendations

**Manual Recommendations** let you decide exactly which products appear together, instead of letting the app choose automatically.

* manually select **target** **products**
* manually select **recommended products**

[Learn more](https://docs.tipo.io/tipo-related-products/~/revisions/mi2RVjGIN1z96wDMyD8H/widget-configuration/manual-recommendations)

***

### ⚙️ Option 4: Automatic recommendations (rules-based)

Let the app choose products automatically using rules.

***

#### Same collection

Shows products from the same collection as the current product.

<figure><img src="/files/0BCy6L3tMAflwjcC72iB" alt=""><figcaption></figcaption></figure>

Best for:

* Category-based recommendations

**Example**\
All products from the **Silver** collection.

***

#### Same tag

Shows products that share at least one tag.

<figure><img src="/files/ac7p6EfYmraXJrgCdx4O" alt=""><figcaption></figcaption></figure>

Best for:

* Seasonal or themed products

**Example**\
Products tagged with `winter`.

***

#### Same vendor

Shows products from the **same vendor/brand**.

<figure><img src="/files/7ZgmxIWDuYz9zoEhVEOm" alt=""><figcaption></figcaption></figure>

Best for:

* Brand-focused stores

***

#### Same product type

Shows products with the same **product type**.

<figure><img src="/files/Z06g94nOmdcZX1F2ce17" alt=""><figcaption></figcaption></figure>

Best for:

* Structured catalogs

***

#### Most relevant products (automated)

This option lets Tipo automatically choose products to recommend.\
You don’t need to select products manually.

The app decides what to show based on the current product and the recommendation intent you choose.

<figure><img src="/files/UIzo8o6Q8mLPLXcKkYm4" alt=""><figcaption></figcaption></figure>

Best for:

* Large catalogs
* Hands-off setup

When a customer views a product:

1. Tipo looks at the current product
2. It finds other products that are most relevant
3. It shows them based on your selected recommendation intent

You only need to choose one intent.

**🎯 Recommendation intents explained**

1\) Related products

Shows products that are similar to the current product.

Tipo uses product data such as:

* Collection
* Product type
* Tags
* Vendor

Best for:

* “You may also like”
* Browsing and discovery

**Example**\
Customer is viewing a **blue shirt** →\
Widget shows **other shirts** from the same collection.

***

**2) Complementary products**

Shows products that are usually bought together with the current product.

Tipo focuses on upsells and cross-sells.

Best for:

* Accessories
* Add-ons
* Bundles

**Example**\
Customer is viewing a **camera** →\
Widget shows **memory card, tripod, camera bag**.

***

## 🛠️ Step 2: Set display order & random option

#### Display order

**Display order** controls the priority of widgets when multiple widgets appear in the same location (same page and position).

* Widgets with a higher number are shown first
* Widgets with a lower number are shown later
* If there is only one widget, display order does not matter

<figure><img src="/files/LdOljf395QbZWAck2jUH" alt=""><figcaption></figcaption></figure>

**Example**

You have 2 widgets on the Product page, both showing below the product form.

Widget A

* Name: Related products
* Display order: **10**

Widget B

* Name: Frequently Bought Together
* Display order: **5**

✅ **Result on the store**

1. Related products (10) → shown first
2. Frequently Bought Together (5) → shown below

***

#### Random display (optional)

* Randomizes product order each time the page loads

<figure><img src="/files/DqppD2JJLfJF2ATE4zjo" alt=""><figcaption></figcaption></figure>

Best for:

* Showing variety
* Avoiding repetitive recommendations

***

## ⚠️ Important notes

* Recommendation rules control **what is shown**, not where
* If no products appear:
  * Check product availability
  * Check collection/tag rules
* Sold-out products follow your **Product display settings**

***

**👉 What’s next?**

After choosing recommended products, you can:

* Adjust **Display order & priority**
* Customize **Design & appearance**
* Set the widget **Active**

***

**🙋 Still need support?**

If you still need help, please feel free to contact us at <hi@tipo.io>. We’ll be happy to assist you further.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.tipo.io/tipo-related-products/widget-setup/choosing-recommended-products.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.