> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.upsell.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to use slots and widgets on Upsell.com | Shopify

## What are slots and widgets?

${youtube}[What are slots & widgets?](5WbmRwxzSsQ)

In this article, you will understand what widgets and slots are, how they work, and how to use them.

### First, some definitions:

**Slots** - these are containers of one or more widgets, placed in a specific location on a store page (for example: below the products in the cart on the checkout page)

**Widgets** - these are specific elements that can be added to a slot and through that to a page (for example: product upsell, product recommendations, etc)

### Next, let's understand the hierarchy:

* Conditions are placed inside **pages**
* Slots are created inside **conditions**, each slot represents a specific location on the page
* Widgets are grouped inside **slots**

Each slot can contain one or more widgets.

You can place a slot on a page through your store pages once, and this will be it's location until you move it. Conditions don't change the slot's location, they only change the widgets inside the slot.

| You can create up to 10 slots per page, learn about them [here](/en/article/how-to-place-slots-in-the-shopify-editor-8qknth/).

### Creating slots and widgets

1. Creating your slot:

To create a slot, click one of the**Create a slot** buttons:

![Creating a slot](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/image_k8lkis.png)

You are now presented with two categories for creating a slot - i) using a custom slot and either building the widgets within the slot from scratch; or ii) duplicating an existing slot

1. **Custom slot**
‎ ‎ ‎ ‎ *‎ **Start from scratch**: Start from scratch and build a slot to match your store's unique requirements‎ ‎ 

![start from scratch](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/scratch2_teth3l.png)
‎ ‎ ‎ ‎ * **Duplicate existing slot**: Quickly replicate an existing saved slot

![duplicate existing slot](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/duplicate2_1oll0ht.png)

2. **Pre-made slots**

(Four **pre-made template slots**: these will insert a slot with the following widgets for quick-start):-

‎ ‎ ‎ ‎ * **product upsell** - this will insert a slot with the [product upsell widget](https://help.upsell.com/en/article/how-to-use-the-product-upsell-widget-shopify-xiq381/) nested within
‎ ‎ ‎ ‎ * **product recommendation** - this will insert a slot with the [product recommendations widget](https://help.upsell.com/en/article/how-to-use-the-product-recommendations-widget-shopify-14zfqza/) nested within
‎ ‎ ‎ ‎ * **bundle** - this will insert a slot with the [bundle widget](https://help.upsell.com/en/article/how-to-use-the-bundle-widget-in-upsellcom-shopify-1c77c8b/) nested within and
‎ ‎ ‎ ‎ * **banner** - this will insert a slot with a [banner widget](https://help.upsell.com/en/article/how-to-use-the-banner-widget-shopify-1h0zjnw/) nested within

Once your slot is created, the first widget for this slot will be automatically created, and you will be redirected to the Upsell.com Editor where you can instantly edit your widget and add further widgets to your slot from within the Upsell.com Editor, before saving and navigating back to the Flow Builder page

![](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/premade2_p240qv.png)

|| Note: Pre-made slots are not available on the post purchase pages - this is due to the nature of the page
|| Note: Only one pre-made slot is available for each widget - i.e. one product upsell slot; one product recommendation slot; one bundle slot; and one banner slot -> but of course once you have created the pre-made slot with that widget, you can add, remove and customize as required -> using the pre-made slot as a base for your own custom build (or alternatively start from scratch with a custom slot)

2. Back on the Flow Builder page, you will see your slot with its widgets created:

![Slot with a widget](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/image_1kz2k55.png)

3. At this point, if you have not done so already via onboarding, you need to add your slot to the page in the Shopify Editor, by clicking **Place your slots in the Shopify editor**:

![Place your slots in the Shopify editor](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/image_1in7fah.png)

|| To learn more on how to place your slots in the Shopify editor, see our article on [placing your slots on the Shopify editor](/en/article/how-to-place-slots-in-the-shopify-editor-8qknth/).

4. You can edit the widgets for this slot, by clicking the widgets card, and then clicking the Edit Widgets button on the actions menu:

![Edit widgets](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/image_1cgi7bh.png)

This will take you back to the Upsell.com Editor to edit your widgets for the slot.

##### Delete widgets

5. You can delete the widgets attached to this slot by clicking the Delete widgets button on the actions menu:

![Delete widgets](https://storage.crisp.chat/users/helpdesk/website/a78a283618511000/image_bdzle4.png)

Once you delete the widgets, your slot will become empty, and you can:-

* continue to the next condition - (If for example your first condition's Slot 1 is empty, Upsell.com will check your next applicable condition to see if Slot 1 exists and if it does, it will show those widgets)
* keep the slot empty - (Upsell.com will not check further conditions to see if Slot 1 is present, even if it is an active condition)
* add widgets to the slot to 'activate' it; or
* completely delete the slot ( **If you delete a slot itself - it will be deleted from all conditions in the page, so exercise caution**)

![](https://storage.crisp.chat/users/helpdesk/website/-/a/7/8/a/a78a283618511000/image_1izv9y5.png)

|| Note for merchants who created slots prior to pre-made templates being made available: If your store previously used these slots, their functionality remains unchanged - only their names have been updated.

### Well, that's a wrap!

If this article did not solve your issue, our support team is available for you 24/7. Just click the live chat button at the bottom-right corner of this page.

| 📢 Did you know we have a YouTube channel? Don't forget to [subscribe to the channel](https://www.youtube.com/channel/UCyhFu9538WtMSUcdFERO4JA) to keep in touch with us and our news and updates
| 🙏 If you find our app useful, help other merchants find it by [leaving us an honest review on the Shopify App Store](https://apps.shopify.com/reconvert-upsell-cross-sell#modal-show=ReviewListingModal)! It means the world to us
| 📧 Please let us know if you spot any typos, mistakes, or omissions via: care@upsell.com