Working with Blocks

Some sections — like an FAQ list, a feature grid, or a footer with navigation links — need to repeat a small unit of content multiple times. Those repeating units are called blocks. A block is a smaller version of a section: it lives inside a section, has its own settings, and you add / remove / reorder them just like sections.

Where blocks appear in the editor

Sections that support blocks expand in the section list to show their blocks underneath, indented one level. Click the chevron next to the section name to expand or collapse it. Each block row works like a section row — drag to reorder, click to select, hover for actions.

Adding a block

Each section that supports blocks has its own + Add block button at the bottom of that section's expanded list. Click it to open a picker scoped to that section's allowed block types — a Footer section won't offer image-card blocks, a Features section won't offer link blocks. Click the type you want and the block lands in the section.

Some sections cap how many blocks you can add (a hero might allow up to 3 buttons; a footer might allow up to 12 link blocks). When you reach the cap, the Add block button is disabled with a tooltip explaining the limit.

Editing a block

Click the block row in the tree, or click the corresponding element in the live preview. The right inspector shows that block's settings — text fields, image pickers, color choices, whatever the theme author exposed for that block type. Edit a value and the preview updates.

Reordering blocks

Drag a block row to reorder it within its parent section. Just like sections, the whole row is the drag target — hover to see the handle. Blocks can only be reordered within their section; you can't drag a block out of one section and into another.

Removing a block

Hover the block row and click the trash icon, or right-click the block and choose Remove. The block and its settings are deleted.

Locked blocks can't be removed

Some blocks have a small lock icon on the right of the row. These blocks are part of the section's required structure — the theme declares them as either static (the section can't render without this block) or required (this block is mandatory by design). The Remove option is disabled and the inline trash icon doesn't appear. You can still edit a locked block's settings; you just can't delete it.

Copying blocks between sections

Right-click a block and choose Copy. Then right-click any section of the same type — or use the section's Paste menu item — and the block is added with the same settings. This is the fastest way to repeat a configured block across multiple sections without rebuilding it.

Nested blocks

Some block types support their own children — a "Mega menu" block in a Header section, for example, might contain "Menu link" blocks. The tree shows them indented under their parent block. The same drag, click, and remove affordances apply at every level.

FAQ

I want a block but the section doesn't have one of those.

Block types are declared by the section, so you can only add types the section's author allowed. If you need a different block type, switch to a section that supports it — or build a custom section in the code editor.

Why is the Add block button disabled?

The section has hit its block limit. Either remove an existing block to make room, or check whether the limit is configurable in the section's settings (some themes expose a "Max items" setting that controls the cap).

Can I move a block to a different section?

Not via drag-and-drop — blocks belong to their parent section. You can copy a block and paste it into another section of a compatible type, which gives you the same effect.

Can I add the same block twice with different settings?

Yes — that's the entire point of blocks. Add the block twice from the picker; configure each instance independently. (For copying configured settings, use Copy / Paste from the context menu.)