For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

Blocks are the building units you place inside sections to compose your pages. Instead of every section carrying a fixed layout, Helix lets you add, reorder, and nest blocks to build the exact content structure each section needs.

This group documents the theme blocks — the reusable blocks available across many sections through the Add block button. Section-specific blocks (such as footer menus or product details) are documented on their own section pages.

Think of blocks as interchangeable puzzle pieces: build a piece once, then add, remove, and rearrange it wherever it makes sense — no coding required.

How blocks work

  • Add a block — In the theme editor, select a section and click Add block. The block picker groups blocks by category (Basic, Layout, Forms, and so on).

  • Reorder — Drag blocks in the section tree to change their order on the page.

  • Nest with Group — The Group block is a container. Place blocks inside a Group to arrange them in a row or column, share a background, or wrap them in a single link. Groups can even sit inside other Groups.

  • Availability — Not every block appears in every section. A section's design decides which block categories it accepts.

Nesting

Blocks live inside sections, and they can also nest inside other blocks. This layering is what lets you build rich layouts from simple pieces — a Group holding a heading, text, and a price, with a second Group inside it holding two buttons:

How blocks nest inside a section

On the left is the block tree as you arrange it in the editor; on the right is how those same blocks render on the storefront.

Theme blocks vs. section-specific blocks. Theme blocks (documented here) are shared and reusable — the same Heading or Image block works in a Hero, a Custom section, or a Group. Section-specific blocks only exist inside the one section that defines them and are documented with that section.

Quick reference

Block
Category
What it does

Basic

Main headline with size, highlight, and animation controls.

Basic

Small label above or below a heading.

Basic

Rich-text paragraph for body copy.

Basic

A grouped Subheading, Heading, and Text section header.

Basic

Single call-to-action link.

Basic

Two side-by-side call-to-action buttons.

Basic

Inline image with ratio and link options.

Basic

Uploaded or external (YouTube/Vimeo) video with a play button.

Basic

An icon from the library or a custom SVG.

Basic

Long text that truncates to a line limit with a show-more toggle.

Basic

Live countdown to a fixed or recurring date.

Basic

Displays a copyable discount code.

Basic

Pulls content from a Shopify page into the block.

Basic

A row of color swatches built from nested Item blocks.

Basic

Before-and-after images with a draggable handle.

Layout

Container that arranges nested blocks in a row or column.

Layout

A responsive grid of equal-width Column blocks.

Layout

An asymmetric grid of varied-height Item tiles.

Layout

Side-by-side table of products or plans, built from Feature and Column blocks.

Layout

Collapsible rows built from nested content.

Layout

A horizontal rule between blocks.

Layout

Adjustable empty space between blocks.

Layout

A continuously scrolling strip of nested content.

Layout

A slider of nested Slide blocks with navigation and autoplay.

Forms

Newsletter form with optional subscription preferences.

Forms

A customizable contact form.

Links

A button that opens a popup, drawer, or bottom sheet holding nested blocks.

Links

Row of icons linking to your social profiles.

Cards

Media card with overlaid, positioned content.

Cards

Small horizontal product card with thumbnail, price, and add to cart.

Product

A short quiz that recommends products or a collection.

Footer

Displays your store's accepted payment methods.

Custom

Insert custom Liquid, HTML, or app snippets.

Utilities

Currency and language selectors.

Utilities

A compact inline row of links from a flat menu.


headset

Need help?

Whether you have a question, run into an issue, or just need some guidance, our support team is here to help.

Chat with us Submit a ticket

Last updated