Content Blocks: Mixing Block Types Inside a Section
Build a section's content from small, reusable blocks — add, reorder, duplicate, and remove Compare Slider, Image, Video, and Quote blocks inside Comparison Carousel.
A handful of sections go beyond their own fixed fields and let you build their content out of blocks instead — small, reusable content pieces you add one at a time, in any mix and any order, inside the section itself.
Screen: Online Store → Pages → [your page] → click the Comparison Carousel section → Blocks panel (it sits below the section's own Content/Layout/Style tabs).
One section today
Right now this is live on exactly one section: Comparison Carousel (the swipeable A↔B product comparison slider — search "comparison" in + Add Section to find it, or see it listed under Product sections). More sections will pick up block support over time; a section either has a Blocks panel or it doesn't, and today most don't.
How it works
- Four block types on Comparison Carousel today: Compare Slider, Image, Video, and Quote.
- Add as many as you like, in any mix — up to 12 blocks total per section.
- Each block can be reordered, duplicated, or removed independently of the others.
- A block you add renders inline as part of the section's own content track, not as a separate strip below it.
Finding the Blocks panel
Open the section's editor as usual — click it in the section stack — and look below its own tabs (Content, Layout, Style, and so on). A Blocks panel sits underneath all of them, staying visible no matter which tab is selected, since blocks aren't tied to any one tab.
Comparison Carousel auto-advances when its own Autoplay setting is on and it has more than one slide (block-built or legacy), and — like the other autoplaying carousels in the library — it carries a visible, keyboard- and touch-operable pause/play control whenever it's auto-advancing, so a shopper can always stop the motion (required by WCAG 2.2.2). With autoplay off, or with only one slide, no pause control appears — that's expected, not a missing control.
Adding a block
Click Add block to open the Add a block dialog: a searchable grid of every available block type, each with a thumbnail and short description. Click a card to add it — the block is inserted at the end of the list and opens automatically for editing.
If a block type has a per-type limit and you've already hit it, its card greys out with Limit reached — X of Y instead of adding another. Comparison Carousel doesn't set a per-type limit on any of its four block types today, so this only matters once the total-block cap below is reached, at which point Add block itself disables.
12-block cap
Comparison Carousel accepts at most 12 blocks in total, across all four types combined. Once you're at 12, Add block disables. If a section somehow ends up over the limit (for example, content brought in from an import), a warning banner tells you how many blocks are past the limit and won't appear on the storefront — the excess isn't deleted, just hidden until you remove enough to get back under 12.
Working with a block
Each block appears as a row with its type label and a one-line preview of its content (its heading, quote, or first label, whichever it has). Click the row to expand it and edit its settings; the same click collapses it again. Alongside each row:
- Move up / Move down — reorder this block relative to its neighbours. Disabled at the top or bottom of the list.
- Duplicate — clone this block with all its current settings, inserted right after the original. Blocked (silently, no error) if duplicating would put you over that block type's per-type limit.
- Remove — asks you to confirm ("Remove this block?") before deleting it; Cancel backs out with no change.
Each block type's settings
Compare Slider
Label A / Label B, Image A / Image B (each with its own alt text via the image picker), Caption, Toggle Style (Match section default, Slider, Button toggle, Side by side, or Fade), and Aspect Ratio (16:9, 4:3, 1:1, 3:4, or 9:16).
Image
An image (with alt text), an optional Caption, an optional Link (opens the same link picker used elsewhere in the editor), and Aspect Ratio.
Video
An uploaded video (your library only — no YouTube/Vimeo embed), an optional poster image, Video Alt text, Caption, Autoplay and Loop switches, and Aspect Ratio. Autoplay is always muted and inline, and is suppressed automatically for visitors with reduced-motion enabled — it's never a way to force sound-on playback.
Quote
Quote text, an optional rich-text version (wins over the plain quote when you fill it in), Author name, Author role, an optional avatar image, and Alignment (Left or Center).
An empty required field on a block (no image on an Image block, no quote text on a Quote block, one missing side of a Compare Slider) means that specific block quietly doesn't render on the storefront — the rest of the section's blocks still do. Half-finished content never ships as a broken half-comparison or an empty card.
Converting old slides to blocks
Comparison Carousel existed before blocks did, storing its before/after pairs as a plain list of slides. If a section still has those old slides and no blocks yet, a Convert slides to blocks button appears above the (empty) Blocks panel. Clicking it asks you to confirm — "Convert slides to blocks? The legacy slide list will be cleared. This can be undone with Undo." — then turns every old slide into its own Compare Slider block, in the same order.
One-way (outside of Undo)
Converting clears the old slide list as part of the same update. If you change your mind right after, Undo brings the slides back — but there's no separate "convert back" action once you've saved and moved on.
If a section somehow ends up with both blocks and leftover legacy slides at the same time, a warning banner explains that the legacy slides are hidden while blocks are in use, and prompts you to convert or delete them.
Why don't I see a Blocks panel on this section?
Only a section whose type declares block support shows the panel — today that's Comparison Carousel alone. Every other section in the library still uses only its own dedicated Content fields; adding a block type there isn't possible yet. If you don't have edit permission on this page, block actions (add, reorder, duplicate, remove) show a read-only notice instead of applying.
