# 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="/files/DxlqVDr7eascjS3KEr9Y" 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 depends 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="/files/GV1jvInYyLCDlZNZpelo">/files/GV1jvInYyLCDlZNZpelo</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#text">/pages/Je2j8VQFFrujz0gUuISl#text</a></td></tr><tr><td align="center"><strong>Collapsible text</strong></td><td><a href="/files/7gKC7PZVPr0lKdC8fvFD">/files/7gKC7PZVPr0lKdC8fvFD</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#collapsible-text">/pages/Je2j8VQFFrujz0gUuISl#collapsible-text</a></td></tr><tr><td align="center"><strong>Button</strong></td><td><a href="/files/Kr991OwOnL7tGLfQKrQK">/files/Kr991OwOnL7tGLfQKrQK</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#button">/pages/Je2j8VQFFrujz0gUuISl#button</a></td></tr><tr><td align="center"><strong>Press</strong></td><td><a href="/files/ml7YBGwEfH7f9veDUqjp">/files/ml7YBGwEfH7f9veDUqjp</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#press">/pages/Je2j8VQFFrujz0gUuISl#press</a></td></tr><tr><td align="center"><strong>Testimonial</strong></td><td><a href="/files/pLA5x7yNZePusqyzSCJc">/files/pLA5x7yNZePusqyzSCJc</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#testimonial">/pages/Je2j8VQFFrujz0gUuISl#testimonial</a></td></tr><tr><td align="center"><strong>Image</strong></td><td><a href="/files/qnKTCgCGbnr7coiXm6Il">/files/qnKTCgCGbnr7coiXm6Il</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#image">/pages/Je2j8VQFFrujz0gUuISl#image</a></td></tr><tr><td align="center"><strong>Image card</strong></td><td><a href="/files/0CXy6Fj2ZYL0egVrlpoZ">/files/0CXy6Fj2ZYL0egVrlpoZ</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#image-card">/pages/Je2j8VQFFrujz0gUuISl#image-card</a></td></tr><tr><td align="center"><strong>Images stack</strong></td><td><a href="/files/0bbSmBE1Ilev2RJq7lGs">/files/0bbSmBE1Ilev2RJq7lGs</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#images-stack">/pages/Je2j8VQFFrujz0gUuISl#images-stack</a></td></tr><tr><td align="center"><strong>Image comparison</strong></td><td><a href="/files/fwQ1CeaVbVUsHEkoDKXp">/files/fwQ1CeaVbVUsHEkoDKXp</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#image-comparison">/pages/Je2j8VQFFrujz0gUuISl#image-comparison</a></td></tr><tr><td align="center"><strong>Card layered</strong></td><td><a href="/files/RbusJynwmC8XO9kkrhdd">/files/RbusJynwmC8XO9kkrhdd</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#card-layered">/pages/Je2j8VQFFrujz0gUuISl#card-layered</a></td></tr><tr><td align="center"><strong>Icon</strong></td><td><a href="/files/nFSAt544W0yEYBRaDExc">/files/nFSAt544W0yEYBRaDExc</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#icon">/pages/Je2j8VQFFrujz0gUuISl#icon</a></td></tr><tr><td align="center"><strong>Icon list</strong></td><td><a href="/files/MdBUvjEWNTDZEnSJ1hS5">/files/MdBUvjEWNTDZEnSJ1hS5</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#icon-list">/pages/Je2j8VQFFrujz0gUuISl#icon-list</a></td></tr><tr><td align="center"><strong>Icon box</strong></td><td><a href="/files/7d5LkG1os6Cvt4EMRbjx">/files/7d5LkG1os6Cvt4EMRbjx</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#icon-box">/pages/Je2j8VQFFrujz0gUuISl#icon-box</a></td></tr><tr><td align="center"><strong>Video</strong></td><td><a href="/files/VHEO7u7j8ysWXOU07eGt">/files/VHEO7u7j8ysWXOU07eGt</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#video">/pages/Je2j8VQFFrujz0gUuISl#video</a></td></tr><tr><td align="center"><strong>Counter</strong></td><td><a href="/files/Osp3Fjf9AdwflX302Odw">/files/Osp3Fjf9AdwflX302Odw</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#counter">/pages/Je2j8VQFFrujz0gUuISl#counter</a></td></tr><tr><td align="center"><strong>Countdown timer</strong></td><td><a href="/files/htprwv4WWDSlXxiPPQ78">/files/htprwv4WWDSlXxiPPQ78</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#countdown-timer">/pages/Je2j8VQFFrujz0gUuISl#countdown-timer</a></td></tr><tr><td align="center"><p><strong>Countdown timer:</strong> </p><p><strong>Icon with text</strong></p></td><td><a href="/files/iG2XvDwX5LOb7B003IkH">/files/iG2XvDwX5LOb7B003IkH</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#countdown-timer-icon-with-text">/pages/Je2j8VQFFrujz0gUuISl#countdown-timer-icon-with-text</a></td></tr><tr><td align="center"><strong>Article card</strong></td><td><a href="/files/f9DLa1hhXNiwMgszTRYv">/files/f9DLa1hhXNiwMgszTRYv</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#article-card">/pages/Je2j8VQFFrujz0gUuISl#article-card</a></td></tr><tr><td align="center"><strong>Divider</strong></td><td><a href="/files/8l0mS2iIgYixGOKduDdP">/files/8l0mS2iIgYixGOKduDdP</a></td><td><a href="/pages/Je2j8VQFFrujz0gUuISl#divider">/pages/Je2j8VQFFrujz0gUuISl#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="/files/8nRZyqlXnCfS2V7voU6s">/files/8nRZyqlXnCfS2V7voU6s</a></td><td><a href="/pages/yUngW5lCQUn2Igc1Ym1P#accordion">/pages/yUngW5lCQUn2Igc1Ym1P#accordion</a></td></tr><tr><td align="center"><strong>Grid</strong></td><td><a href="/files/1nvRR70cyOAitgwcpyEo">/files/1nvRR70cyOAitgwcpyEo</a></td><td><a href="/pages/yUngW5lCQUn2Igc1Ym1P#grid">/pages/yUngW5lCQUn2Igc1Ym1P#grid</a></td></tr><tr><td align="center"><strong>Group</strong></td><td><a href="/files/pgeoR7mFXOMB19ZFY6fj">/files/pgeoR7mFXOMB19ZFY6fj</a></td><td><a href="/pages/yUngW5lCQUn2Igc1Ym1P#group">/pages/yUngW5lCQUn2Igc1Ym1P#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="/files/Q7Luy6Z0Q8uZkflsXQdz">/files/Q7Luy6Z0Q8uZkflsXQdz</a></td><td><a href="/pages/C2U2cyiytbNybBp8Mddo#image-with-badges">/pages/C2U2cyiytbNybBp8Mddo#image-with-badges</a></td></tr><tr><td align="center"><strong>Marquee</strong></td><td><a href="/files/UmbJ2cc7mRABTn1HHHzz">/files/UmbJ2cc7mRABTn1HHHzz</a></td><td><a href="/pages/C2U2cyiytbNybBp8Mddo#marquee">/pages/C2U2cyiytbNybBp8Mddo#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="/files/J2O7MpIpS8KNU8Zo1FGn">/files/J2O7MpIpS8KNU8Zo1FGn</a></td><td><a href="/pages/RMa9NJ6eW6Uf7ajRLH2v#collection-card">/pages/RMa9NJ6eW6Uf7ajRLH2v#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="/files/zbZC6AoFlp9S5rdYW8Kg">/files/zbZC6AoFlp9S5rdYW8Kg</a></td><td><a href="/pages/Sg9VwOrEhpNFJak9NKbQ#custom-liquid">/pages/Sg9VwOrEhpNFJak9NKbQ#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="/files/LGSLwC5LYU2XVjbfLKIa">/files/LGSLwC5LYU2XVjbfLKIa</a></td><td><a href="/pages/LUT3BGa79hAMoIGOWxpU#newsletter">/pages/LUT3BGa79hAMoIGOWxpU#newsletter</a></td></tr><tr><td align="center"><strong>Contact form</strong></td><td><a href="/files/d5RJqyHwNu8L0SfTE4Lk">/files/d5RJqyHwNu8L0SfTE4Lk</a></td><td><a href="/pages/LUT3BGa79hAMoIGOWxpU#contact-form">/pages/LUT3BGa79hAMoIGOWxpU#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="/files/NE1lmLP5PdLEzWIfVJ46">/files/NE1lmLP5PdLEzWIfVJ46</a></td><td><a href="/pages/HVkXnp8DHK7S5fFGOVPo#lookbook-card">/pages/HVkXnp8DHK7S5fFGOVPo#lookbook-card</a></td></tr><tr><td align="center"><strong>Product card</strong></td><td><a href="/files/1SlUtVXYqCODkn1RvTse">/files/1SlUtVXYqCODkn1RvTse</a></td><td><a href="/pages/HVkXnp8DHK7S5fFGOVPo#product-card">/pages/HVkXnp8DHK7S5fFGOVPo#product-card</a></td></tr><tr><td align="center"><strong>Product overlay card</strong></td><td><a href="/files/fEkIzivVfo5GBAkk7zYM">/files/fEkIzivVfo5GBAkk7zYM</a></td><td><a href="/pages/HVkXnp8DHK7S5fFGOVPo#product-overlay-card">/pages/HVkXnp8DHK7S5fFGOVPo#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="/files/BvAD9sbrMQWwVArzi9QV">/files/BvAD9sbrMQWwVArzi9QV</a></td><td><a href="/pages/IVnB4pjtLJNHB2ilTkOe#locator">/pages/IVnB4pjtLJNHB2ilTkOe#locator</a></td></tr><tr><td align="center"><strong>Section header</strong></td><td><a href="/files/PU2kJEeCUNUVuSdyuUBM">/files/PU2kJEeCUNUVuSdyuUBM</a></td><td><a href="/pages/IVnB4pjtLJNHB2ilTkOe#section-header">/pages/IVnB4pjtLJNHB2ilTkOe#section-header</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/pebble-theme/theme-blocks/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.