> 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/create-a-widget.md).

# Create a widget

Follow these general steps to create a widget and show product recommendations on your store.

### 🛠️ Step 1: Open the Widgets page

1. Open the app > click **Widgets**
2. Click **Add widget button**

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

***

### 🛠️ Step 2: Choose widget placement

Placement decides where the widget will appear on your store.

1. Select a **placement**:
   * **Product page**
   * **Collection page**
   * **Home page**
   * **Cart page**
   * **Search page**
   * **Thank you page**
2. Click **Next**.

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

**Example**\
Choose **Product page** to show recommendations on product pages.

***

### 🛠️ Step 3: Choose widget layout

Layout decides how the widget looks and works.

1. Select a **layout**:
   * **Related products**
   * **Frequently Bought Together**
   * **Add-ons**
   * **Recently viewed**
2. Click **Next**.

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

***

### 🛠️ Step 4: Configure widget settings

Now you’ll see the widget editor.

1. Enter a **widget title** (optional)
2. Choose **where this widget applies** (targeting)
3. Choose **which products to recommend**
4. Adjust basic settings if needed.

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

***

### 🛠️ Step 5: Set targeting rules

Targeting controls which products or pages this widget applies to.

1. **Choose one option:**
   * **All products**
   * **Specific products**
   * **Collections**
   * **Product tags**
2. Save your selection

**Example**\
Show this widget only for products in the **“Silver”** collection.

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

***

### 🛠️ Step 6: Choose recommended products

Decide what products appear inside the widget.

1. Choose how products are selected:
   * **Manual** (pick specific products)
   * **Automatic** (same collection, tag, vendor, product type)
2. **Save** the widget

**Example**\
Automatically recommend products from the **same collection**.

***

### 🛠️Step 7: Customize the design (optional)

1. Click **Customize** > it directs you to the app **Settings**
2. Adjust layout, number of products, buttons, and colors
3. Save changes

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

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

***

### 🛠️ Step 8: Activate and save

1. Set the widget status to **Active**
2. Click **Save**

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

🎉 Your widget is now created.

***

### **▶️** A Tutorial video <a href="#a-reference-video" id="a-reference-video"></a>

{% embed url="<https://youtu.be/pPtFL6dSYi0?si=M2hAn7TE-uSXcl8u>" %}

***

### 👉 Next step

To make the widget visible on your store, continue to [**Display a widget**.](https://docs.tipo.io/tipo-related-products/~/revisions/qdRatoxOPwCce935iatJ/widget-setup/display-a-widget)