> For the complete documentation index, see [llms.txt](https://uxsmart.gitbook.io/velare/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uxsmart.gitbook.io/velare/customize-your-pages/storytelling/flexible-section.md).

# Flexible section

**Flexible section** is the empty canvas of the theme. Instead of arriving with a fixed layout, it lets you stack theme blocks in any order and decide how they are arranged, how tall the section is, and what sits behind them. Shoppers see it as any other band on the page, but it is the section to reach for when nothing in the ready made list matches the layout in your head: a two column brand story, a row of stat cards over a video, a call to action panel with a photo behind it.

Because it starts blank, it takes more setup than the other sections. Use it where the payoff is worth that time.

<figure><img src="/files/YZpuqzTY3xakZORxPupo" alt=""><figcaption></figcaption></figure>

### Where to find it <a href="#where-to-find-it" id="where-to-find-it"></a>

{% hint style="success" %}
**Steps:**

1. Go to **Online Store > Themes > Customize**.
2. Open the template you want to build on.
3. Click **Add section** and choose **Flexible section** from the **Storytelling** group.
4. Click **Add block** and pick the blocks that make up your layout.
5. Set **Direction** first, then adjust height, spacing, and background.
   {% endhint %}

*Result:* an empty section is added, and each block you add appears inside it following the direction and gap you set.

## **Section settings**

### General

<figure><img src="/files/hn2HpRGZNIiRHLto8CtV" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Section width</strong></td><td><p>How much of the screen the section is allowed to take.</p><p><strong>• Stretch width:</strong> The content spreads to the browser width, which suits wide multi column layouts.</p><p><strong>• Fixed width:</strong> The content lines up with the rest of your pages, using the width set in <strong>Theme settings > Layout</strong>.</p><p><strong>• Full width:</strong> Section and content run edge to edge, the option to pick when a background image should bleed off the screen.</p></td></tr><tr><td><strong>Color scheme</strong></td><td>The background and text colors the section starts from. Schemes are defined in <strong>Theme settings > Colors</strong>, so editing one there restyles every section built on it.</td></tr></tbody></table>

### Layout

**Vertical Layout**

<figure><img src="/files/9IDQ4h9b6AkUW1Ddf0Tw" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Direction</strong></td><td><p>Whether the blocks sit above one another or side by side. This is the first thing to set, because the rest of the layout settings change with it.</p><p><strong>• Vertical:</strong> Blocks stack down the page, one under the next.</p><p><strong>• Horizontal:</strong> Blocks sit in a row across the page.</p></td></tr><tr><td><strong>Height</strong></td><td>How tall the section is regardless of how little content it holds. Use a taller preset when a background image needs room to be seen.</td></tr><tr><td><strong>Custom height</strong></td><td>An exact height in place of the presets, for when the section has to line up with a neighbouring design.</td></tr><tr><td><strong>Position</strong></td><td>Where the stack of blocks sits between the top and bottom of the section, which only becomes visible once the section is taller than its content.</td></tr><tr><td><strong>Alignment</strong></td><td>Which edge the blocks line up with from left to right. Centre reads as more formal, left as more editorial.</td></tr><tr><td><strong>Gap</strong></td><td>The space left between one block and the next. Increase it when the blocks read as one lump instead of separate ideas.</td></tr></tbody></table>

**Horizontal Layout**

<figure><img src="/files/Gajlm4gzdCgasvZmPwBj" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Direction</strong></td><td><p>Whether the blocks sit above one another or side by side. This is the first thing to set, because the rest of the layout settings change with it.</p><p><strong>• Vertical:</strong> Blocks stack down the page, one under the next.</p><p><strong>• Horizontal:</strong> Blocks sit in a row across the page.</p></td></tr><tr><td><strong>Vertical on mobile</strong></td><td>Turns the row into a stack on phones, so each block gets the full screen width instead of being squeezed into a narrow column.</td></tr><tr><td><strong>Content wrap</strong></td><td>Lets blocks drop onto a second line when the row runs out of room, rather than shrinking to fit. Useful once you have four or more blocks in a row.</td></tr><tr><td><strong>Height</strong></td><td>How tall the section is regardless of how little content it holds. Use a taller preset when a background image needs room to be seen.</td></tr><tr><td><strong>Custom height</strong></td><td>An exact height in place of the presets, for when the section has to line up with a neighbouring design.</td></tr><tr><td><strong>Position</strong></td><td>Where the row of blocks sits between the left and right edges of the section, which shows once the blocks are narrower than the section.</td></tr><tr><td><strong>Alignment</strong></td><td>How blocks of different heights line up against each other, for example whether their tops or their centres match.</td></tr><tr><td><strong>Gap</strong></td><td>The space left between one block and the next. Increase it when the blocks read as one lump instead of separate ideas.</td></tr></tbody></table>

### Mobile settings

<figure><img src="/files/ZvHnyH7bAduhQJS7B3Fw" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Carousel on mobile</strong></td><td>Turns the blocks into a swipeable strip on phones, so a long row costs one screen instead of endless scrolling.</td></tr><tr><td><strong>Item per row</strong></td><td>How many blocks share the width of a phone screen. Two shows more at once, one keeps each block readable.</td></tr><tr><td><strong>Column gap</strong></td><td>The space between blocks on mobile. A small gap still tells shoppers where one block ends and the next begins.</td></tr></tbody></table>

### Appearance

<figure><img src="/files/GKuXChM9B4UXdXYBONOm" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Background media</strong></td><td><p>What sits behind the blocks, on top of the color scheme.</p><p><strong>• None:</strong> The color scheme alone shows through.</p><p><strong>• Image:</strong> A photograph fills the section behind the blocks.</p><p><strong>• Video:</strong> A hosted video plays behind the blocks, which draws more attention but costs more to load.</p></td></tr><tr><td><strong>Image</strong></td><td>The photograph shown behind the blocks. Pick one with a calm area where the text will land.<br><em>* Note: Only appears when <strong>Background media</strong> is set to <strong>Image</strong></em></td></tr><tr><td><strong>Video local</strong></td><td>The hosted video played behind the blocks. Short and quiet clips work best, since shoppers are meant to read over it.<br><em>* Note: Only appears when <strong>Background media</strong> is set to <strong>Video</strong></em></td></tr><tr><td><strong>Padding block</strong></td><td>The space kept between the background media and the blocks on top of it, so the wording does not sit against the edge of the picture.<br><em>* Note: Only appears for <strong>Image</strong> and <strong>Video</strong> backgrounds</em></td></tr></tbody></table>

<figure><img src="/files/v3I32YUlvt98MjfGeDzO" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Border radius</strong></td><td><p>How the corners of the section are shaped.</p><p><strong>• None:</strong> Square corners, which read as sharper and more editorial.</p><p><strong>• Custom:</strong> Rounded corners at a value you choose, softening the block against the page.</p></td></tr><tr><td><strong>Custom radius</strong></td><td>How rounded those corners are. Higher values give a softer, card like shape.<br><em>* Note: Only appears when <strong>Border radius</strong> is set to <strong>Custom</strong></em></td></tr><tr><td><strong>Background inside container</strong></td><td>Keeps the background within the page content width instead of letting it run to the browser edges, so the section reads as a card on the page rather than a full width band.</td></tr><tr><td><strong>Background overlay</strong></td><td>Lays a tint over the background media. Turn it on when the picture is busy and the wording on top is hard to read.</td></tr><tr><td><strong>Overlay color</strong></td><td>The color of that tint. Dark tints suit light text, light tints suit dark text.<br><em>* Note: Only appears when <strong>Background overlay</strong> is enabled</em></td></tr></tbody></table>

<figure><img src="/files/h2Dj8OwFX5WQvEjeMdZk" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Overlay style</strong></td><td><p>How the tint is spread across the picture.</p><p><strong>• Solid</strong>: an even tint over the whole picture, the safest choice for readability.<br><strong>• Gradient</strong>: the tint fades away across the picture, so one part of the photo stays clear.</p></td></tr><tr><td><strong>Overlay opacity</strong></td><td>How strong that tint is. Raise it until the wording is comfortable to read, then stop, because every step also hides more of the picture.</td></tr><tr><td><strong>Gradient direction</strong></td><td><p>Which end of the section the tint is heaviest at. Point it at the side where the text sits.</p><p><strong>• Up</strong></p><p><strong>• Down</strong></p></td></tr></tbody></table>

### Section padding

<figure><img src="/files/TbzonCqoSJ5VYpScLHcI" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th>Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Padding top</strong></td><td>Adds space above the section. Increase it when this section sits too close to the one before it.</td></tr><tr><td><strong>Padding bottom</strong></td><td>Adds space below the section. Increase it when the next section starts too abruptly.</td></tr></tbody></table>

## **Block settings**

You can find out more [here](https://app.gitbook.com/s/JPcCAMRfixyNMwC5LwQw/group-blocks).

### What changes on the storefront <a href="#what-changes" id="what-changes"></a>

* Nothing renders until you add blocks. An empty flexible section shows only its background and its height.
* **Direction** governs everything else in the layout, so changing it later means revisiting the position, alignment, and gap settings.
* A video background is the heaviest option on the page. Reserve it for one section per template, not several.

### Related pages <a href="#related-pages" id="related-pages"></a>

* [Storytelling](/velare/customize-your-pages/storytelling.md): the group this section belongs to
* [Basic blocks](/velare/customize-your-pages/basic.md) and [Layout blocks](/velare/customize-your-pages/layout.md): the blocks you fill this section with
* [Multi-content](/velare/customize-your-pages/storytelling/multi-content.md): a more guided alternative when you only need a row of mixed content
* [Colors](/velare/set-up-your-store/colors.md) and [Layout](/velare/set-up-your-store/layout.md): where the color schemes and the fixed page width come from


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://uxsmart.gitbook.io/velare/customize-your-pages/storytelling/flexible-section.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
