> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/grid.md).

# Grid

Build a flexible grid of image and text cards, each with its own width, for promotions, collection links or key numbers.

The Grid section lets you build your own layout from Image and Text cards. You choose the width of each card, so you can mix one large card with two small ones, make a row of four, or create a full-width banner. Cards can show a heading or a large number (with an optional count-up animation), a description, collection links and a button.

### 1. How to add the section

In the theme editor, click **Add section** and choose **Grid** (in the **Storytelling** category). The section is added with one Text card and one Image card.

### 2. Section settings

**General**

* **Desktop media height:** the height of the cards on desktop. Options: Adapt to first media height (all cards follow the shape of the first card's image), Small, Medium or Large.

**Mobile layout**

* **Mobile media height:** the same options for mobile.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}

### 3. Block settings

Add **Image** blocks for cards with a background image and **Text** blocks for cards with a plain or colored background. Both share most settings.

* **Desktop width:** how much of the row the card takes on desktop. Options: 25%, 33%, 50%, 66%, 75% or 100%. Cards wrap to a new row when a row is full, so combine widths that add up to 100% (for example 50% + 50%, or 33% + 66%).
* **Image** (Image block only):
  * **Image:** the card's background image.
  * **Image overlay opacity:** darkens the image so the text is easier to read.
  * **Overlay style:** Gradient from bottom, Gradient from top or Full image darken.
* **Text:**
  * **Subheading:** small text above the heading.
  * **Heading type:** Heading or Number.
    * **Heading:** the card title (when Heading type is Heading).
    * **Number**, **Prefix** and **Suffix:** a large number with an optional symbol before it (such as $ or +) and text after it (such as %, K or +), for example "150+" (when Heading type is Number).
    * **Enable count-up animation:** the number counts up from zero when the card scrolls into view.
  * **Heading size:** Small, Medium or Large.
  * **Description:** the text below the heading.
  * **Destop content position:** where the text sits in the card on desktop, from Top left to Bottom right. On mobile, the position is adjusted automatically.
* **Collection links:**
  * **Collections:** pick up to 6 collections to show as links in the card.
* **Button:**
  * **Show button**, **Button label**, **Button link** and **Button style** (Solid, Outline or Text).
* **Colors:** turn on **Use custom colors** to set the card's **Text** color and the **Button** color scheme. Text blocks also have a **Background** color.
* **Mobile layout:**
  * **Mobile width:** 50% or 100% of the screen width.
  * **Mobile content alignment:** Left, Center or Right.

{% hint style="info" %}
**Note:** On Image cards without custom colors, the text and buttons are shown in white so they stand out on the image.
{% endhint %}
