Placements and layouts
Which templates a widget can draw on, and the four shapes it can take.
Every widget has one placement and one layout. The placement decides which template it can draw on; the layout decides what it looks like and what a shopper can do with it.
Placements
Set under Where it appears. The block only ever draws a widget whose placement matches the template the block is sitting on.
| Placement | Where the block goes |
|---|---|
| Product page | Your product template. The most common by far. |
| Collection page | A collection template. |
| Cart | The cart template. A Pro placement — see Free and Pro. |
| Home page | Your index template. |
| Search results | The search template. |
Layouts
| Layout | What it is |
|---|---|
| Recommended products | A row of related items shoppers can browse. Renders as a carousel, grid or list. |
| Buy together | A bundle with a checkbox per item, a running total, and one-click add. Pro. |
| Add-ons | A compact strip of complementary items, for accessories and consumables. |
| Recently viewed | What this shopper looked at earlier, resolved entirely in their own browser. |
Carousel, grid or list
Under Appearance, most layouts can render three ways. Buy together is always a list — a bundle with checkboxes down one side does not work as a carousel, so the app forces it rather than letting you save something that renders with arrows beside a list that never scrolls.
How many products
The widget sets its own maximum; the block can lower it for one placement. So a widget set to eight, placed with a block set to four, shows four. This lets the same widget be generous on a wide product page and restrained in a narrow column, without a second widget.
Something here wrong or missing? Tell us — we would rather fix the page than answer the same question twice.