Block types
Blocks come in three types depending on where you place them. Type is not a separate field you pick — it follows from the placement you choose. Pick a placement and the type is decided for you.
The three types
Section titled “The three types”| Type | Where you’d use it | Typical content |
|---|---|---|
| Complex | Anchored on a product page, cart, footer, or other in-page location | Trust badges, coupons, button groups — most cases |
| Floating | Pinned to a viewport edge (top / bottom / left / right) and stays as the visitor scrolls | Quick-link icons, support buttons, sticky promos |
| Label | Overlaid on product images (product detail page and collection cards) | Small chips like “Sale 25%”, “New”, “Limited” |
How types differ
Section titled “How types differ”| Aspect | Complex | Floating | Label |
|---|---|---|---|
| Mounts on | A theme element you anchor it to | The viewport itself (fixed position) | Product image |
| Number of components | Multiple, in any layout | Multiple, in any layout | One label chip per block |
| Editor experience | Component list editor | Component list editor | Anchor picker + single-chip editor |
| Target tab dimensions | Full 8 visibility dimensions | Full 8 visibility dimensions | 8 dimensions + a scope control (PDP / Cards / Both) |
Type cannot change after creation
Section titled “Type cannot change after creation”The editor does not let you switch a block between Label and non-Label. The two are structurally different (Label holds exactly one chip on a product image; Complex / Floating can hold an arbitrary component tree), so an automatic conversion would risk losing your data.
Saves and duplications that try to cross types are rejected on the server.
To change type → create a new block. Duplicating across types is also disallowed.
Wizard prevents type-incompatible templates
Section titled “Wizard prevents type-incompatible templates”When you pick a placement in the wizard, the template list auto-filters to templates compatible with that placement. Submitting an incompatible template is also rejected on the server, in case the filter was bypassed.