# Display order & priority

**Display order** and **priority** control which widget shows first and which products are preferred when there are multiple options.

## **Display order**

### ℹ️ What is Display order?

**Display order** controls the priority between widgets that appear in the same location.

📌 Rule to remember:\
**Higher number = shown first**

<figure><img src="https://3173367560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRM5h2vtdtoVXQ1FbxweB%2Fuploads%2FMXy2kbPEbeuqzTNFaCm6%2F2025-12-19_18-10-11.png?alt=media&#x26;token=599772ab-9e27-4979-88c8-10bfeb331ad0" alt=""><figcaption></figcaption></figure>

***

### ⚙️ How Display order works

* Only applies when multiple widgets appear:
  * On the same page
  * In the same position (e.g. below product form)
* If there is only one widget, display order does nothing

***

### 🧪 Example

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

| Widget name                | Display order |
| -------------------------- | ------------- |
| Related products           | 10            |
| Frequently Bought Together | 5             |

**Result on storefront**

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

***

### 🛠️ How to set Display order

1. Open the app > click **Widget** > open the widget you want to edit
2. Scroll to **Choose Recommended Products**
3. Find **Display order**
4. Enter a number
5. Click **Save**

<figure><img src="https://3173367560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRM5h2vtdtoVXQ1FbxweB%2Fuploads%2F8MISsbffTtIf13SEeAg2%2F2025-12-19_19-26-45.png?alt=media&#x26;token=f164d66d-558f-4486-9d18-9e97b659a600" alt=""><figcaption></figcaption></figure>

***

### ⭐ Recommended Display order values

To keep things simple:

* **100** → Main / most important widget
* **50** → Secondary widget
* **10** → Optional widget

💡 Tip\
Leave space between numbers so you can reorder later.

***

## **Higher priority**

### ℹ️ What is “Higher priority”?

Some recommendation types (like **Same Collection** or **Same Tag**) help the app decide which products to prefer first.

This does not change where the widget appears, only affects which products are chosen inside the widget.

***

#### ⚙️ Higher priority: Same Collection

When a product belongs to multiple collections, you can select a higher priority collection.

**How it works**

* App first tries to recommend products from the selected collection
* If not enough products are found, it uses other collections

**Example**

* Product belongs to: **Silver** + **Gold**
* Higher priority collection: **Silver**
* Result: Recommendations prefer *Shoes* products

<figure><img src="https://3173367560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRM5h2vtdtoVXQ1FbxweB%2Fuploads%2Fg0yHYhZX4hUp1GIYMv8e%2F2025-12-19_19-30-51.png?alt=media&#x26;token=c837c34b-be7f-4bf8-8245-b804aca93fc8" alt=""><figcaption></figcaption></figure>

***

#### ⚙️ Higher priority: Same Tag

When a product has many tags, you can choose a priority tag.

**How it works**

* App prefers products that share the selected tag
* Other tags are used only if needed

**Example**

* Product tags: `silver`, `gold`, `titan`
* Priority tag: `silver`
* Result: Shows silver-related products first

<figure><img src="https://3173367560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRM5h2vtdtoVXQ1FbxweB%2Fuploads%2FPh32AzS0QO53MN5h36pH%2F2025-12-19_19-31-59.png?alt=media&#x26;token=8decb25a-05c6-4c04-a61c-d8ab50cc3468" alt=""><figcaption></figcaption></figure>

***

### 🔀 What does “Random” do?

**Random** changes the order of products inside the widget each time the page loads.

<figure><img src="https://3173367560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRM5h2vtdtoVXQ1FbxweB%2Fuploads%2FZgiuHEG3SHMPMrNzGM0R%2F2025-12-19_18-08-24.png?alt=media&#x26;token=cad8d13f-3cf5-4515-98a9-26cb6d3a9869" alt=""><figcaption></figcaption></figure>

* Does not affect widget priority
* Does not affect Display order
* Only changes product order inside the widget

Best for:

* Showing variety
* Avoiding repetitive recommendations

***

**⚠️ Common misunderstandings**

* Display order does NOT control product order
* Display order does NOT affect targeting
* Higher priority does NOT move the widget position

✔ Display order → widget priority\
✔ Higher priority → product selection priority\
✔ Random → product order only

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