Placement modes — auto vs manual
There are two basic ways to place a block:
| Mode | What it does | How you pick it |
|---|---|---|
| Auto | The app picks the spot for you, based on your theme’s structure | Pick one of the location cards (full list: Placement reference) |
| Manual | You drop the block onto a specific theme template yourself | Pick the Custom Position card |
When to choose Auto
Section titled “When to choose Auto”- You want it to just work, without touching theme code
- The target spot is a standard Shopify location (near Add-to-cart, cart, footer, etc.)
- Your theme is in the supported list (most cases)
In Auto mode:
- Pick any of the location cards (see Placement reference)
- The app finds the right spot for your theme automatically
- If the theme isn’t supported, the diagnostic panel shows “No available placement on this page” — switch theme, switch placement, or fill custom anchor selectors
When to choose Manual
Section titled “When to choose Manual”- You want exact control (e.g. mount inside a specific custom section)
- Your theme isn’t supported and custom anchors aren’t flexible enough
- You want to drop the same block at different spots across multiple templates
In Manual mode:
- Pick Custom Position → the editor shows the block ID and an “Add to theme” button
- Open the Shopify theme editor → drop the TT Badges & Product Labels block onto the section you want → paste the block ID into the block’s settings
- Save the theme; the block renders at that position
Full walkthrough: Custom placement.
Switching between modes
Section titled “Switching between modes”Switching placement cards keeps everything else (visibility rules, components, color scheme) intact — only the placement itself changes. The editor’s save bar appears so you can save the new placement.
Diagnostics
Section titled “Diagnostics”In Auto mode, the Target tab diagnostic panel shows the actual spot the block landed on — useful when the block appears but not where you expected.
In Manual mode, the diagnostic panel just shows “Custom Position” (the block goes wherever you dropped it).
Related
Section titled “Related”- Custom anchor selectors and the placement reference: Placement reference and custom anchors
- Manual placement step-by-step: Custom placement