# Welcome to Bricks

<div data-with-frame="true"><figure><img src="https://3153492654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OXqzfeMzu7qGScWOhnB%2Fuploads%2F2XrayeCVmBTKDhzcpFZP%2F3146257638749875090.png?alt=media&#x26;token=21374955-4b99-4244-9cc1-9fb8b8cfd4f7" alt=""><figcaption></figcaption></figure></div>

Bricks is a premium Shopify theme built around a composable block-based architecture. Every section can accept any block type, and a block that works in one section works in any other, so you can rearrange content freely as your store evolves.

## Understanding theme blocks

Theme blocks are blocks that are defined within your theme and can have dynamic functionality, such as nesting. Sections that accept theme blocks can accept a variety of different blocks, depending on the section's structure. 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 might also have the following behaviors:

Some blocks support nesting, so that you can nest blocks within other blocks up to eight levels.

Some sections have required blocks. You can customize or hide these blocks, but you can't re-order or delete them.

Some blocks display automatically in a section when certain conditions are met.

### Example of a section with theme blocks

For example, your theme has a Slideshow section with theme blocks.

In the slideshow section of your theme, when you click Plus circle Add block, you can select a Slide block from the block picker. No other block types are available. If you try to add a Slide block to another section in your theme, such as an Image banner section, then Slide isn't available. This is an example of a restricted block.

After you add a Slide block to the Slideshow section, you can click Plus circle Add block to add additional blocks to any Slide blocks in the Slideshow section, such as a Heading, Image, Button. These blocks are nested in the Slide block. This is an example of a nested block.

If you add a second Slide block to the Slideshow section, then the theme automatically adds a Slideshow controls block. This block displays buttons that visitors to your site can click to navigate from one slide to the another. You can customize the style of buttons or hide the controls, but you can't remove or delete the block. This is an example of a required block that displays conditionally.

```
Slideshow section
├─ Slide block                          (restricted — only valid inside Slideshow)
│  ├─ Heading block                     (nested)
│  ├─ Image block                       (nested)
│  └─ Button block                      (nested)
├─ Slide block
│  └─ … nested blocks …
└─ Slideshow controls block             (required, auto-added when ≥ 2 slides)
```

## Where to go next

* [Theme settings](https://getsitecontrol.gitbook.io/bricks-theme/theme-settings/theme-settings) — global defaults for colors, typography, layout, and more.
* [Header](https://getsitecontrol.gitbook.io/bricks-theme/header-group/header-group), [Footer](https://getsitecontrol.gitbook.io/bricks-theme/footer-group/footer-group), [Overlay](https://getsitecontrol.gitbook.io/bricks-theme/overlay-group/overlay-group) — the section groups that appear on every page of the theme.
* **Sections**, **Main blocks**, **Specific blocks**, and **Templates** — browse the full catalogues from the sidebar.

## Contact support

If you need assistance, our Support Team is always happy to help you out. Click the link below and fill in the contact form — our team will get back to you shortly. Please, provide as much detail as possible for a prompt and effective response.

[Contact support](https://getsitecontrol.getform.com/l15wd)


---

# 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://getsitecontrol.gitbook.io/bricks-theme/readme.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.
