# Overview

{% hint style="info" %}
For general guidance on modifying sections, refer to Shopify help: [Sections and blocks](https://help.shopify.com/manual/online-store/themes/theme-structure/sections-and-blocks)
{% endhint %}

## 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.

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FiGFKwewElAuploZU6QYZ%2Fimage.png?alt=media&#x26;token=e708df7f-e9bd-4595-84a9-818f45ce08ef" alt=""><figcaption><p>Theme blocks can accept other nested blocks as children</p></figcaption></figure>

{% hint style="warning" %}

* 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.&#x20;
  {% endhint %}

<details>

<summary>Theme blocks vs Section blocks</summary>

{% hint style="info" %}
Section blocks are designed for a specific section. A section can have limits for the types of section blocks, and limit the number of a certain type of block that you can add.
{% endhint %}

<table><thead><tr><th width="144"></th><th width="255">Section blocks</th><th>Theme blocks</th></tr></thead><tbody><tr><td>Scope of use</td><td>Defined inside a section; usable only within that section.</td><td>Defined at the theme level; reusable across different sections.</td></tr><tr><td>File location</td><td>Defined within a section's Liquid file and schema (inside <code>sections/xyz.liquid</code> with <code>"blocks": …</code> in the schema).</td><td>Defined as its own file (in <code>/blocks/</code>) alongside other block types.</td></tr><tr><td>Nesting</td><td>Usually single-level: section > block. Section blocks cannot be nested.</td><td>Support nesting: theme blocks can have nested theme blocks/child blocks up to several levels.</td></tr><tr><td>Use case </td><td>Simple, self-contained sections where block types are tightly bound to the section.</td><td>Complex layouts, shared components, nested structures, advanced customization, multi-section usage of same block type.</td></tr></tbody></table>

</details>

## 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.&#x20;

{% tabs %}
{% tab title="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.&#x20;
{% endtab %}

{% tab title="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.&#x20;

*Example:* The **Product media** block and **Product details** block in the **Product information** section.&#x20;
{% endtab %}

{% tab title="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.
{% endtab %}
{% endtabs %}

## Explore theme block categories

### Basic

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Text</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FCYShX0b60fxfxzoVjMOn%2FFox-BG%20Light%20(97).jpg?alt=media&#x26;token=5433049e-cd75-4832-99dd-18ebed5cf64d">Fox-BG Light (97).jpg</a></td><td><a href="../basic#text">#text</a></td></tr><tr><td align="center"><strong>Collapsible text</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F2kcyhDX8etAjgwDtzYRh%2FFox-BG%20Light%20(87).jpg?alt=media&#x26;token=e47daa98-99f5-4c85-98a9-e6bba7f3044c">Fox-BG Light (87).jpg</a></td><td><a href="../basic#collapsible-text">#collapsible-text</a></td></tr><tr><td align="center"><strong>Button</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FINtgOFezLeF2BGhdvlWm%2FFox-BG%20Light%20(85).jpg?alt=media&#x26;token=364ae091-8ae5-4e20-af2a-9ec3cb58a823">Fox-BG Light (85).jpg</a></td><td><a href="../basic#button">#button</a></td></tr><tr><td align="center"><strong>Press</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FJLsTmxChQGHiyRvCVRda%2FFox-BG%20Light%20(95).jpg?alt=media&#x26;token=be742edd-4bdf-4bbb-b718-ce93a9ae0fcd">Fox-BG Light (95).jpg</a></td><td><a href="../basic#press">#press</a></td></tr><tr><td align="center"><strong>Testimonial</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FBLvbEJN1n8m4EuCcw7gF%2FFox-BG%20Light%20(96).jpg?alt=media&#x26;token=110055ca-ff40-46a0-aa6b-f8a4019ebb53">Fox-BG Light (96).jpg</a></td><td><a href="../basic#testimonial">#testimonial</a></td></tr><tr><td align="center"><strong>Image</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FewkxvC1hHbTUs15KKZeu%2FFox-BG%20Light%20(92).jpg?alt=media&#x26;token=09f3aea7-ff81-49c4-90f2-930b60ea45dd">Fox-BG Light (92).jpg</a></td><td><a href="../basic#image">#image</a></td></tr><tr><td align="center"><strong>Image card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FoR4ht2aCEOi8biJ24o7y%2FFox-BG%20Light%20(93).jpg?alt=media&#x26;token=40d313ef-fe61-4a9d-9968-1fcce5ff5be1">Fox-BG Light (93).jpg</a></td><td><a href="../basic#image-card">#image-card</a></td></tr><tr><td align="center"><strong>Images stack</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FV8VCQtZWb3xsxOXnM1IY%2FFox-BG%20Light%20(94).jpg?alt=media&#x26;token=5bdb78eb-3f12-4cda-87fc-61ac958f714c">Fox-BG Light (94).jpg</a></td><td><a href="../basic#images-stack">#images-stack</a></td></tr><tr><td align="center"><strong>Card layered</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fuoeom3iDmpRJ8GH8t7Hb%2FFox-BG%20Light%20(86).jpg?alt=media&#x26;token=232ad7fe-5706-4961-9b9b-cdc3b53296c9">Fox-BG Light (86).jpg</a></td><td><a href="../basic#card-layered">#card-layered</a></td></tr><tr><td align="center"><strong>Icon</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F0oK5xOYBBQzUt729mhkz%2FFox-BG%20Light%20(90).jpg?alt=media&#x26;token=7e2d05ed-9299-4465-9339-c7ea36e2d4c6">Fox-BG Light (90).jpg</a></td><td><a href="../basic#icon">#icon</a></td></tr><tr><td align="center"><strong>Icon box</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FQfafo3ScCKaab37azGxO%2FFox-BG%20Light%20(91).jpg?alt=media&#x26;token=d61b6009-ef5a-478a-8aa2-6dbcb54f74e3">Fox-BG Light (91).jpg</a></td><td><a href="../basic#icon-box">#icon-box</a></td></tr><tr><td align="center"><strong>Video</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fazj8LstaD6O8YFpLuR99%2FFox-BG%20Light%20(98).jpg?alt=media&#x26;token=5c366244-2a68-48bd-a8e8-2287d65aba5f">Fox-BG Light (98).jpg</a></td><td><a href="../basic#video">#video</a></td></tr><tr><td align="center"><strong>Countdown timer</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F6oQtMGskM6A3QoU0kVZC%2FFox-BG%20Light%20(88).jpg?alt=media&#x26;token=a3cb203d-a76a-46e9-9006-f465588cb0ff">Fox-BG Light (88).jpg</a></td><td></td></tr><tr><td align="center"><p><strong>Countdown timer:</strong> </p><p><strong>Icon with text</strong></p></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FmNwq2AcfvOAu1YK2uDIc%2FFox-BG%20Light%20(89).jpg?alt=media&#x26;token=68d1b7fd-b805-4972-8307-d10f9d80d025">Fox-BG Light (89).jpg</a></td><td><a href="../basic#countdown-timer-icon-with-text">#countdown-timer-icon-with-text</a></td></tr><tr><td align="center"><strong>Article card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FVdm0i6qtUGdRcG3m5UGJ%2FFox-BG%20Light%20(84).jpg?alt=media&#x26;token=7fff3c78-696d-47dd-be44-2c2db7e41e9c">Fox-BG Light (84).jpg</a></td><td><a href="../basic#article-card">#article-card</a></td></tr><tr><td align="center"><strong>Divider</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FPM7mSYqJmMwogD89sqPm%2FFox-BG%20Light%20(99).jpg?alt=media&#x26;token=d7cfd721-a21d-4174-93a2-6d7e84189cc5">Fox-BG Light (99).jpg</a></td><td><a href="../basic#divider">#divider</a></td></tr></tbody></table>

### Layout

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Accordion</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FiHan6RkrTHgdQ6JpiRgq%2FFox-BG%20Light%20(100).jpg?alt=media&#x26;token=cc32ead8-2851-4e2a-a32d-a8cd3a779cdf">Fox-BG Light (100).jpg</a></td><td><a href="../layout#accordion">#accordion</a></td></tr><tr><td align="center"><strong>Grid</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F1BrgugjaQVE3TBJxQNo1%2FFox-BG%20Light%20-%202025-11-17T174256.657.jpg?alt=media&#x26;token=63f23f76-cf6f-4323-bb22-9c3e163eef4c">Fox-BG Light - 2025-11-17T174256.657.jpg</a></td><td><a href="../layout#grid">#grid</a></td></tr><tr><td align="center"><strong>Group</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F3GIAPJ9aTGRMgU33foa3%2FFox-BG%20Light%20-%202025-11-17T174406.961.jpg?alt=media&#x26;token=441bd974-c190-4db2-bdbf-e4f44bc19f24">Fox-BG Light - 2025-11-17T174406.961.jpg</a></td><td><a href="../layout#group">#group</a></td></tr></tbody></table>

### Banners

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Image with badges</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FIR86MRH1G2hHMgJF0xBy%2FFox-BG%20Light%20-%202025-11-17T174606.936.jpg?alt=media&#x26;token=1dfa21c9-742d-459d-8ed3-60de56ecf7d9">Fox-BG Light - 2025-11-17T174606.936.jpg</a></td><td><a href="../banners#image-with-badges">#image-with-badges</a></td></tr><tr><td align="center"><strong>Marquee</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FIpi60fGHNafTNE1A7BJm%2FFox-BG%20Light%20-%202025-11-18T095639.304.jpg?alt=media&#x26;token=370009f1-b3d6-431a-b7c6-388f25256eaa">Fox-BG Light - 2025-11-18T095639.304.jpg</a></td><td><a href="../banners#marquee">#marquee</a></td></tr></tbody></table>

### Collection

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Collection card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F9bLdBtHgcabqXsZlN8Fa%2FFox-BG%20Light%20-%202025-11-18T100009.275.jpg?alt=media&#x26;token=b3fd5211-d578-48ae-9f9c-b408a47866a0">Fox-BG Light - 2025-11-18T100009.275.jpg</a></td><td><a href="../collection#collection-card">#collection-card</a></td></tr></tbody></table>

### Custom

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Custom liquid</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FnjalaKmMpS9b6wMNqkXl%2FFox-BG%20Light%20-%202025-11-18T100336.004.jpg?alt=media&#x26;token=3c57d243-4390-422b-a7ec-fb824814efde">Fox-BG Light - 2025-11-18T100336.004.jpg</a></td><td><a href="../custom#custom-liquid">#custom-liquid</a></td></tr></tbody></table>

### Forms

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Newsletter</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FkuO1mnDjNts1br7IuCPX%2FFox-BG%20Light%20-%202025-11-18T101230.959.jpg?alt=media&#x26;token=e28f0026-19ae-4da1-99ba-38b8d969dc48">Fox-BG Light - 2025-11-18T101230.959.jpg</a></td><td><a href="../forms#newsletter">#newsletter</a></td></tr><tr><td align="center"><strong>Contact form</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FDRTNozYQ78hDQhfYgOBw%2FFox-BG%20Light%20-%202025-11-18T101654.536.jpg?alt=media&#x26;token=c87cb7d5-57d5-4154-b5c4-000361a82691">Fox-BG Light - 2025-11-18T101654.536.jpg</a></td><td><a href="../forms#contact-form">#contact-form</a></td></tr></tbody></table>

### Product

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Lookbook card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FsbHiFQQuQ8zebwpypw9F%2FFox-BG%20Light%20-%202025-11-18T102035.223.jpg?alt=media&#x26;token=625e1f7d-05a2-4b45-8483-4c9c030e18ac">Fox-BG Light - 2025-11-18T102035.223.jpg</a></td><td><a href="../product#lookbook-card">#lookbook-card</a></td></tr><tr><td align="center"><strong>Product card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fkwy4ZdRxDaSnbe3GhKtS%2FFox-BG%20Light%20-%202025-11-18T102207.747.jpg?alt=media&#x26;token=ad3e1d94-0541-4526-968b-6bc4c066f46b">Fox-BG Light - 2025-11-18T102207.747.jpg</a></td><td><a href="../product#product-card">#product-card</a></td></tr><tr><td align="center"><strong>Product overlay card</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FpERd9ybmVjkYDtjPryna%2FFox-BG%20Light%20-%202025-11-18T102354.492.jpg?alt=media&#x26;token=63ea0fed-50bd-4a34-a22b-7bd1e6cb022f">Fox-BG Light - 2025-11-18T102354.492.jpg</a></td><td><a href="../product#product-overlay-card">#product-overlay-card</a></td></tr></tbody></table>

### Storytelling

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Locator</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FsENaP0e9qSMYCRcbWfpa%2FFox-BG%20Light%20-%202025-11-18T102620.300.jpg?alt=media&#x26;token=b53f57ec-e4a8-422a-b64c-ee3c5b3f2f1f">Fox-BG Light - 2025-11-18T102620.300.jpg</a></td><td><a href="../storytelling#locator">#locator</a></td></tr><tr><td align="center"><strong>Section header</strong></td><td><a href="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FSYGcIgvjJSODDuZbwb1p%2FFox-BG%20Light%20-%202025-11-18T102808.412.jpg?alt=media&#x26;token=d2cac164-caa7-4130-a3c1-959495380c51">Fox-BG Light - 2025-11-18T102808.412.jpg</a></td><td><a href="../storytelling#section-header">#section-header</a></td></tr></tbody></table>