> For the complete documentation index, see [llms.txt](https://help.brickspacelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brickspacelab.com/slab/content/blocks/layout/flex-grid/flex-item.md).

# Flex item

## Overview

A flexible container item designed to be used within layout\_\_flex.liquid for creating customizable layouts. Supports fit, fill, or custom responsive widths, alignment controls, spacing, optional sticky positioning, and optional load or scroll animations.

## Block limitations

This is a private block. It is intended for use only within specific parent blocks and should not be added directly to sections.

## Common use cases

* Use with layout\_\_flex.liquid to create flexible grid-like layouts
* Choose **Width** **Fill** so a column grows, **Fit** for natural width, or **Custom** with mobile and desktop percentages
* Turn on **Show advanced settings** to adjust device visibility, sticky behavior, or entrance motion
* Adjust gap size to maintain consistent spacing between nested elements

## Compatible blocks

The following blocks can be nested within this block:

* All theme blocks
* App blocks

## Block settings

### General

| Setting                | Description                                                                              | Options                   |
| ---------------------- | ---------------------------------------------------------------------------------------- | ------------------------- |
| Show advanced settings | Reveals device visibility, sticky layout, sticky position, and load or scroll animations | Checkbox (default: false) |

### Spacing

| Setting                 | Description                               | Options                                                                      |
| ----------------------- | ----------------------------------------- | ---------------------------------------------------------------------------- |
| Enable padding          | Adds padding around the flex item content | Checkbox (default: false)                                                    |
| Enable vertical spacing | Adds vertical padding (top and bottom)    | Checkbox (default: true)                                                     |
| Gap size                | Spacing between child blocks              | <p>• None<br>• Default (default)<br>• XS<br>• SM<br>• MD<br>• LG<br>• XL</p> |

### Color

| Setting            | Description                          | Options                                                                                                                                                                                                                   |
| ------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type               | Custom scheme vs preset surface pair | <p>• Custom<br>• Base (default)</p><p><br><br>Visible when <strong>Enable inheritance</strong> is off</p>                                                                                                                 |
| Color scheme       | Background and text                  | <p>Color scheme picker<br><br>Visible when type is <strong>Custom</strong> and <strong>Enable inheritance</strong> is off</p>                                                                                             |
| Color scheme       | Background and text                  | <p>• Body background<br>• Body foreground<br>• Accent 1–3<br>• Shade 1–3<br>• Blur<br>• Transparent (default)</p><p><br><br>Visible when type is <strong>Base</strong> and <strong>Enable inheritance</strong> is off</p> |
| Color border       | Border color                         | <p>• Subtle (default)<br>• Strong<br>• None</p><p><br><br>Visible when <strong>Border position</strong> is not <strong>None</strong>, type is <strong>Base</strong>, and <strong>Enable inheritance</strong> is off</p>   |
| Enable inheritance | Inherit colors from a parent block   | Checkbox (default: false)                                                                                                                                                                                                 |

### Style

| Setting         | Description                   | Options                                                                                                            |
| --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Border position | Controls where borders appear | <p>• None (default)<br>• Top<br>• Bottom<br>• Left<br>• Right<br>• Top and bottom<br>• Left and right<br>• All</p> |

### Layout

| Setting              | Description                                  | Options                                                                                                                                                          |
| -------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Width                | How the item sizes in the flex row           | <p>• Fit (content width)<br>• Fill (grow to use free space)<br>• Custom (default) — use mobile and desktop sliders</p>                                           |
| Width mobile         | Width on small screens                       | <p>5–100 %, step 5 (default: 80 %)<br><br>Visible when <strong>Width</strong> is <strong>Custom</strong></p>                                                     |
| Width desktop        | Width on large screens                       | <p>5–100 %, step 5 (default: 40 %)<br><br>Visible when <strong>Width</strong> is <strong>Custom</strong></p>                                                     |
| Vertical alignment   | Aligns nested content vertically in the item | <p>• Top<br>• Middle<br>• Bottom (default)</p>                                                                                                                   |
| Enable sticky layout | Enables sticky positioning for this item     | <p>Checkbox (default: false)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                               |
| Sticky position      | Edge the sticky item pins to                 | <p>• None (default)<br>• Top<br>• Bottom</p><p><br><br>Visible when <strong>Show advanced settings</strong> and <strong>Enable sticky layout</strong> are on</p> |

### Display

| Setting          | Description                          | Options                                                                                                                                                                                                                                        |
| ---------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Visibility       | Device visibility                    | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                                                             |
| Load animation   | Animation when the block first loads | <p>• None (default)<br>• Fade<br>• Fade up<br>• Offset fade<br>• Offset fade up</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on and <strong>Scroll animation</strong> is <strong>None</strong></p>                    |
| Scroll animation | Animation tied to scroll position    | <p>• None (default)<br>• Fade<br>• Fade up<br>• Fade down<br>• Slide left<br>• Slide right<br>• Zoom</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on and <strong>Load animation</strong> is <strong>None</strong></p> |


---

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

```
GET https://help.brickspacelab.com/slab/content/blocks/layout/flex-grid/flex-item.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.
