Theme blocks
Theme blocks in Combine: the heading, text, button, image and other blocks you add inside flex sections and their cards.
Applies to: Combine 4.2.0 and later. Added in: Combine 1.0.0. Last checked: 2026-10-13 against Combine 4.2.0.
Theme blocks are the small content pieces of Combine's flex sections: headings, text, buttons, images and a few more. You add them with Add block inside a slide, card or column, and drag them into any order.
This page lists every theme block and the page that documents its settings.
Where you can add theme blocks
Theme blocks go only inside the four flex sections, one level down, in their containers:
| Section | Container you add first | Theme blocks inside |
|---|---|---|
| Flex slideshow | Image slide or Video slide | Any theme block |
| Flex grid | Text card (a Media card holds no blocks) | Any theme block |
| Flex cards | Card | Any theme block |
| Flex columns | Column | Any theme block |
The containers also accept app blocks from your installed apps. Every other Combine section has its own section blocks, documented on that section's page; theme blocks cannot be added there. See Flex sections for how to build a layout.
Which block do I use?
Combine 4.2.0 has 11 theme blocks.
| Block in Add block | Page | Use it for |
|---|---|---|
| Button | Button block | A link styled as a button, for example "Shop now". |
| Caption | Caption block | A short line of small text, or a badge with a background color. |
| Content group | Content group block | Buttons, images, captions or quick buy buttons side by side in one row. |
| Custom Liquid | Custom Liquid block | Your own Liquid or HTML code inside a card. |
| Divider | Divider block | A horizontal line between blocks. |
| Empty space | Empty space block | Extra vertical space between blocks. |
| Heading | Heading block | Titles, with a heading tag for search engines. |
| Image | Image block | A small image at a fixed height: an icon, a badge or a logo. |
| Quick buy button | Quick buy button block | An add to cart button for one product. |
| Star rating | Star rating block | Decorative stars with a rating you set, for social proof. |
| Text | Text block | Paragraphs and lists. |
Can I add a theme block to any section?
No. Theme blocks can be added only inside the slides, cards and columns of Flex slideshow, Flex grid, Flex cards and Flex columns. Sections such as Rich text or Media with text overlay have their own blocks with similar names (Heading, Text, Button), which are part of that section and are set up on its page.
Related pages
- Flex sections: the four sections that hold theme blocks and how to build a layout with them.
- How Combine is built: sections, section blocks and theme blocks.
- General section styling: the heading, colors and margins most sections share.