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.

• 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 depend 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

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

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

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