Layout blocks
In short: Layout blocks in the editor: containers, rows, columns, grids, Divider, Spacer, Accordion, Tabs, Stepper, Timeline, FAQ, Table and lists, with every setting.
Layout blocks are the structure other blocks sit in: containers with rows, columns and grids, dividers and spacers, plus grouped content such as accordions, tabs, steppers, timelines, FAQ lists, tables and lists. They organize a page more than they carry content themselves.
Where to find it
Open a page in the editor (Sidebar → STOREFRONT → Pages), then:
- Containers. Press Add, then Layout.
- You get an empty Column, Row or Grid to fill.
- In the Layers panel's Add tab the Layout shelf offers Container (an empty box with its own width, inside space and background), Row · 2 columns (two boxes side by side), Stack (things one under another with even space) and Grid · 3 columns (3 across on a computer and 2 on a phone).
- Everything else. Press Add, then Component, and open Structure. See Add a section or a block.
The blocks
| Block | What it puts on the page |
|---|---|
Divider | A horizontal line between sections. |
Spacer | Deliberate empty space. The right way to separate two things — better than padding a block until the gap looks right. |
AccentLine | A short coloured line, usually under a heading. Decorative, and useful for signalling where a section starts. |
AccordionRoot | A stack of collapsible rows. Keeps a long page short, at the cost of hiding what is inside. |
AccordionItem | One collapsible row inside an accordion. |
TabsRoot | Tabbed content. Good for alternatives — Description / Shipping / Returns — and bad for anything people need to compare side by side. |
TabPanel | The contents of one tab. Lives inside a Tabs block. |
StepperRoot | Numbered steps. Use when the order genuinely matters — a decorative numbering on unordered items misleads. |
TimelineRoot | A sequence of steps or dates in order. Suits a process or a course outline. |
FAQListRoot | A list of questions and answers. Also feeds the structured data search engines read. |
FAQItem | One question and its answer, inside an FAQ list. |
CarouselRoot | A slideshow. Only the first slide is reliably seen, so put what matters there. |
PremiumTemplate | A pre-built section from the premium set — a whole layout in one block, ready to have its content swapped. |
LegacySection | An older section type kept so existing pages keep working. Not offered for new pages — use the current blocks instead. |
The blocks below are in the editor but not in the table: Process list, FAQ accordion, Searchable FAQ, Card grid, Table, List and Checklist. Each is described in this page.
Containers: sections, rows, columns and grids
A section is the top-level container of a page; a nested container inside it makes columns. Pick a ready-made shape when you add one:
| Group | Choices |
|---|---|
| Stacks | Single column, 2 rows, 3 rows, 4 rows |
| Columns | 2 equal columns, 60 / 40 split, 40 / 60 split, 3 equal columns, Hero + 2 sidebars, 2 sidebars + hero |
| Grids | Grid · 2 × 2 (4 items), Grid · 3 × 2 (6 items), Grid · 3 × 3 (9 items), Grid · 4 × 2 (8 items) |
| Centered | 5 items · 3 + 2 centered, 7 items · 4 + 3 centered |
| Strips | Strip · 4 columns up to Strip · 10 columns (no wrap) |
With a container selected, the inspector's Layout tab has these groups:
| Group | Settings |
|---|---|
| Structure | Layout (the shapes above, and Layout per device), Box style: Flat, Tinted, Card, Glass or Outlined; Background width: Inherit page, Edge-to-edge or Boxed band. |
| Sizing | Width mode and Height mode: Fill (stretch to the parent), Hug (shrink to the content) or Fixed (exact Width (%) or Height (px)); Content fit; Content bounds (Stay inside or Can overflow); Edge bleed (None, Full width, Bleed left, Bleed right). |
| Spacing | Padding with Amount (Compact, Standard, Spacious, Custom) and per-side values; Gap ("the space between the things inside; padding is the space around them"). |
| Alignment | Text alignment, Content position (a 3 by 3 grid), Vertical alignment, Min height (px). |
| Position | Sticky (pin the section while scrolling), Floating CTA bar (pin to the Top or Bottom of the screen, optionally Dismissible), Overlap previous (Pull-up (px)). |
| Responsive | Visible on: All devices, Web only, and so on, per device. |
- A section also has a Section width choice: Same as page, As designed, Full bleed, Reading column · 720px, Narrow · 1080px, Wide · 1280px, Extra wide · 1376px, Full, Follows the screen, or Custom (px)…, and a Max width (px).
- A row with several columns cannot use Edge-to-edge, because a band cannot break out of one column without landing off-center.
Good rules to know: rows cannot go inside rows, a column cannot hold more columns, and you cannot nest elements inside a link or a button. The Layers panel tells you why a drop was refused.
Divider and Spacer
- Divider draws a separator.
- Styles include Line, Dashed, Dotted, Dots · large, Wave, Double, Zigzag and Gradient, plus short accent bars (Accent bar · short, · with dot, · gradient).
- Settings: Width (Fill, Fixed or Hug), Align, Spacing (Compact, Standard, Roomy), Thickness (px), Color, Sides, Dash length, Gap between dashes, Number of waves.
- Let things follow this line turns the line into a path other elements can travel along (curve shapes Straight, Gentle curve, S-curve, Arc, Wave, Curve height).
- Spacer adds empty vertical space. Height is XS, S, M, L, XL, 2XL, 3XL or 4XL; you can also drag the spacer's handle on the canvas. If a spacer is only there to pad a container, Use container padding instead converts it.
Accordion
A set of collapsible items. Each Accordion item has a title and content. Open one answer at a time and First answer starts open control how it opens. Multi-open accordion lets several stay open.
Tabs
Tabs holds a tab list; each Tab (panel) holds its own blocks (Add block). A panel can show an inline FAQ. A button elsewhere on the page can open a particular tab (Goes to → Open tab).
Stepper, Timeline and Process list
| Block | What it does and its settings |
|---|---|
| Stepper | A numbered step sequence. Layout: Horizontal or Vertical. You are here (step number), Show step labels, Display mode: Show where I am or All equal. Each step has Step title, Description and Icon (replaces number). |
| Timeline | A timeline of events ("Event 1", "Event 2" and so on) that you add, reorder and edit in the inspector. |
| Process list | Steps, a timeline or a roadmap on one rope line. Layout: Zigzag (the line turns back), Line (one vertical list) or Wrap (balanced rows); Max per row, Max visible, Current item, Start numbering at. Each item has Title, Description, Date, Weeks, Tag (optional), Bullets, Goal line, and Hide this step. On a phone it is one vertical line and the numbering is always 1 to N. Prefer it over Stepper and Timeline for new pages; existing ones keep working. |
FAQ
Three FAQ blocks exist; they all keep every answer readable.
- FAQ accordion is the one to use on new pages.
- How answers open: First open, All closed, All open or One at a time.
- Optional Search box and Topic filter (each question gets a Topic), a Link name so a question can be linked as an anchor, Include in Google FAQ data (search engines) and Show on the page (off keeps it in your list but hides it).
- FAQ list (the original block) has Questions (Question, Answer, Starts open), Opens by default, Section eyebrow and Section heading.
- Searchable FAQ adds a real search box that filters the answers as visitors type; it shows every answer expanded. It suits lists of ten or more.
Repeating cards
A Repeating cards setting turns a card you design once into a row or grid of many. Select the card's container and open Repeating cards in the inspector:
| Setting | What it does |
|---|---|
| What it lists | Manual list (you write each card), Products, Blog posts, Collections, Tags, or This page's blog post. |
| How many items | The most cards to show, even if you have more items. |
| Which part shows what | Say which part of your card shows each piece of an item: Title, Text, Picture, and for posts Category, Date, Author, Read time and Post text. Automatic works for most cards; None, keep my words leaves a part as you typed it. |
| Card opens the item's page | When on, clicking a card opens that item's own page. |
| Leave out this page's product / Leave out this post | On a product page, shows your other products; on a post page, skips the post being read. |
| Category buttons and Load more button | For blog posts: buttons above that show one category at a time, and a button that loads further posts (the limit no longer applies). |
The first card is your design; every item gets its own copy of it. Products appear only because you chose Products. The editor can also notice that cards look like your products and ask "Connect?" with Connect and Not now.
Card grid, Table, List and Checklist
| Block | What it does |
|---|---|
| Card grid | A grid of flat cards from a list: each card has an eyebrow, a heading, a body and a note, an icon or image, and one link. Use it for features, team members, locations or contact channels instead of copying one card many times. A card that needs a video or a second button stays as a container with blocks. |
| Table | A real grid of rows and columns where each cell can be text, an icon with text or an image: comparison tables, spec sheets, schedules. |
| List | A numbered, lettered or bulleted list with real list semantics and nested sub-items (Add sub-item), for clauses, outlines and plain lists. |
| Checklist | A list where each row is included (tick) or excluded; rows can be indented (top level, nested, deeply nested) and each row can use a different icon (check, cross, minus). |
Steps: build two columns
- Press Add between two sections and choose Layout, then pick 2 equal columns (or 60 / 40 split).
- Click inside the left column, press Add, and add a Heading; do the same in the right column with an Image.
- Select the container and open the Layout tab to set Gap and Padding.
- Switch the canvas to phone: columns stack. For a section with a picture beside words, Order on a phone (in the section settings) chooses which half shows first: Picture first or Words first.
What happens, and what doesn't
- Interactive blocks (accordion, tabs, stepper, timeline, FAQ) are a root holding items. Adding or deleting items happens in the inspector or the Layers panel; the root cannot be left empty, so the delete button is disabled on the last item ("delete the section instead").
- Empty containers used as spacers are kept on the live page, so intentional gaps survive publishing.
- Column and row choices are the same on every device unless you set Layout per device.
- Premium and Legacy sections show up in the Layers panel as one block: a premium section keeps its own motion and layout (see Premium templates); a legacy section is an older section type kept so old pages still work.
Questions
How do I make columns in the editor?
Add a Layout, then pick Row, 2 equal columns, 60 / 40 split or another shape. Each box is a nested container you can fill with blocks.
Why can I not drop something into this box?
Rows cannot sit inside rows, a column cannot hold more columns, and nothing can go inside a button or link. The Layers panel names the reason when it refuses a drop.
What is the difference between FAQ accordion and FAQ list?
FAQ accordion is the newer block with a search box, topic filter, anchor links and FAQ data for search engines. FAQ list is the original block that still renders on existing pages.
How do I add space between two blocks?
Add a Spacer, or set Gap on the container that holds them. Gap is the space between things inside; padding is the space around them.