Overview

For general guidance on modifying sections, refer to Shopify help: Sections and blocks

What are theme blocks?

Theme blocks are reusable blocks that are defined at the theme level and can be nested. A section that accepts theme blocks might accept all available theme blocks, a specific subset of blocks, or blocks unique to that section.

Theme blocks can accept other nested blocks as children

Each section can have up to 50 blocks. The exact number of blocks and the number of each type of block that you can add to each section depends on the section and block sources.
Blocks that support nesting can have up to eight levels of nested blocks.

Types of theme blocks

Theme blocks can behave differently depending on how they're defined in the theme. Below are the three main types you'll encounter when customizing your store.

Private blocks are theme blocks that only appear within specific sections. They're built exclusively for those sections and can't be reused elsewhere.

Example: The Image slide block is only available in the Slideshow section.

Static blocks are required by the theme's design to preserve functionality or structure. They can't be removed or reordered, and can only be hidden.

Example: The Product media block and Product details block in the Product information section.

Dynamic blocks are flexible blocks that merchants can freely add, remove, or reorder within a section. They allow more creative control and layout customization.

Explore theme block categories

Last updated 25 days ago

#What are theme blocks?

Theme blocks vs Section blocks

#Types of theme blocks

#Explore theme block categories

#Basic

#Layout

#Banners

#Collection

#Custom

#Forms

#Product

#Storytelling

ON THIS PAGE

What are theme blocks?

Types of theme blocks

Explore theme block categories

Basic

Layout

Banners

Collection

Custom

Forms

Product

Storytelling