Storefront Settings¶
The single source of truth for everything visual on the storefront block. Open via Settings → Storefront.
These settings override the theme editor
Layout, hover, prices, SKU visibility, variant selector, and add-to-cart visibility all live here. The Parts Diagram block in the theme editor exposes only the per-deployment API base URL. This avoids two-source-of-truth confusion.
Layout¶
The overall arrangement of the diagram and its parts list.
| Layout | Best for |
|---|---|
| Side panel (default) | Wide product pages — diagram on the left, scrollable parts list on the right |
| Overlay | Narrow pages or mobile-heavy stores — parts list overlays the image, with hotspot click expanding inline detail |
| Popup-only | Minimal layouts — diagram only, parts surface in a modal popup on click |
The chosen layout applies to every diagram on the storefront.
Hover effect¶
Controls how a hotspot reacts when a shopper points at it (or its matching parts-list row).
- Highlight (default) — a colored outline pulses around the hotspot, and the side-panel row scrolls into view.
- Spotlight — surrounding image area dims; the hotspot stays fully bright.
- Off — no visual change on hover. Click is still active.
Display toggles¶
| Toggle | Default | What it controls |
|---|---|---|
| Show prices | On | Show variant price next to each part. When the variant has a compare_at_price higher than the live price, both show — sale price first, regular struck through. |
| Show SKU | On | Show the variant SKU as a small caption under the part name. |
| Show variant selector | On | When a hotspot maps to a product (not a specific variant), show the variant picker inside the popup. Hotspots locked to a single variant ignore this — they never show a picker. |
| Show add-to-cart | On | Render the inline Add to cart button in the popup. When off, clicking a hotspot opens the popup but shoppers must navigate to the product page to buy. |
| Show hotspot numbers | On | Render small numeric badges on each hotspot, useful when the diagram has a printed legend in the image itself. |
Variant swatches¶
When a hotspot popup shows a variant picker:
- Single-variant products — variant picker is hidden when the only
variant is the auto-default
Default Title. - Color / size swatches — if your variants use option names like Color or Material, the picker renders as visual swatches. Otherwise it falls back to a dropdown.
Sale & out-of-stock behavior¶
- When a variant has
compare_at_price > price, the side-panel and popup show the sale price with the regular price struck through. - When a variant is sold out, the quantity field and the Add to cart button are disabled, and the inline state reads Sold out.
These behaviors are always on — there are no toggles for them.
Saving¶
Settings save to the app and apply on next storefront page load — no theme republish needed. Use Storefront Preview to verify changes before they reach shoppers.