Editing Section Blocks in the Theme Editor

What Are Section Blocks?

Some theme sections contain repeating content units called blocks — for example, a Testimonials section where each testimonial is a block, or a Features section where each feature card is a block. Each block has its own settings (text, image, link) separate from the section's overall settings.

Open a Section's Blocks

1. Open the Visual Editor for your theme: go to Online Store → Themes and click Customize.
2. Click any section in the preview or select it from the page structure panel on the left.
3. In the right panel, the section's own settings appear at the top. Scroll down — below the settings you will see the Blocks accordion.
4. Each block in the section is listed as a collapsible row labeled with the block's type name and, if the block has a text field, a preview of its content.

Edit a Block's Content

1. Click a block row in the accordion to expand it.
2. The block's settings fields appear below the row — the same kinds of inputs as section settings: text, image picker, color, toggle, etc.
3. Edit the field values. The storefront preview updates in real time.
4. When a block row is expanded, the preview highlights the matching element in the storefront with a brief pulse animation so you know exactly which block you are editing.
5. Click Save to publish your changes.

What the Visual Editor Supports for Blocks

• Editing any block's settings fields with live preview.
• Seeing which block in the storefront corresponds to the row you have open.

What Requires the Code Editor

Structural changes to blocks — adding a new block, removing a block, changing a block's type, or reordering blocks — require the Code Editor (Online Store → Themes → Actions → Edit code). Open the template JSON file for the relevant page (e.g. templates/index.json for the home page) and edit the blocks map and block_order array directly.

Why Are My Blocks Not Showing in the Accordion?

• The section has no blocks configured — the accordion does not appear if the section has zero blocks in its template JSON. Use the code editor to add a block first.
• The section's Liquid file does not support blocks — not every section uses blocks. The block panel only appears for sections whose schema declares a blocks array.
• Nested blocks are not supported — Cartly does not support blocks-within-blocks. If your theme declares nested blocks, they are silently ignored by the renderer.