> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/sections/media/multicolumn.md).

# Multicolumn

Multicolumn section settings in the Avante Shopify theme — column counts, mobile layout, masonry grid, and looping video columns.

Multicolumn is the theme's workhorse grid: a row of equal columns, each with an image, a looping video or just text, plus a heading, a line of copy and a link. Use it for a three-step "how it works", a set of category tiles, service highlights, or a row of brand values.

It is intentionally plain, which is why it fits almost anywhere — but the number of columns it actually shows is calculated rather than set directly, and that catches people out.

{% hint style="info" %}
**Theme Editor → Add section → Multicolumn**
{% endhint %}

***

### How to add

{% stepper %}
{% step %}

### Add the section

In the Theme Editor, click **Add section** and choose **Multicolumn**.
{% endstep %}

{% step %}

### Add columns

Click **Add block** and pick a block type: **Image**, **Loop video** or **Text**. There is no cap on the number of blocks.
{% endstep %}

{% step %}

### Set the layout

Choose **Max columns** for desktop and **Mobile layout** for phones, then check the result at both sizes.
{% endstep %}
{% endstepper %}

***

### Good to know

**Mobile shows two columns by default.** **Mobile layout** ships set to 2, so columns sit side by side on phones and the text inside them gets narrow. Switch it to 1 if your columns carry more than a few words. A section with a single block always drops to one column on mobile regardless of this setting.

**"Max columns: Default" is not the same as "one column per block".** On Default the theme derives the count from how many blocks you have: two blocks give two columns, three blocks give three, and **four or more blocks give two columns**, not four. If you want four across, set **Max columns** to 4 explicitly — and note that each explicit value also steps down when there are too few blocks to fill it.

**Masonry only works at the Original image ratio.** **Enable masonry grid** has no effect unless **Image ratio** is set to **Original** — and the ratio defaults to **Square**, so switching masonry on by itself changes nothing. It also depends on image loading animations being enabled in Theme settings; with image loading disabled the section falls back to a fixed grid.

**The Loop video block takes a Shopify-hosted video only.** It uses Shopify's video picker, so the file has to be uploaded to **Content → Files** (or the product's media) — a YouTube or Vimeo link cannot go here. For an embedded player, use the [Video](https://staylime.com/docs/avante-themes/sections/media/video.md) section instead.

**Video columns start muted with no controls.** The video loads without autoplay or controls and is started by the theme, which is what keeps it a background loop rather than a player. Pause and mute buttons are opt-in, and the **Controls position** setting only appears once one of them is enabled.

**"Make whole block clickable" needs a link.** The setting does nothing on its own — the column only becomes clickable when **Button link** is filled in, even if the button itself is hidden.

**The section is hidden when it has no blocks**, and it **cannot be added to the header, footer or overlay groups**.

***

### Customization ideas

**Icons instead of photos.** Square images of simple line icons on a flat background make a clean "why buy from us" row — the section does not need photography to look finished.

**One video among the images.** Mixing a single Loop video block into a row of Image blocks draws the eye to that column without any extra settings.

**Make the whole tile a link.** For category tiles, enable **Make whole block clickable** with a link and hide the button — the result reads as a tile rather than as text with a button under it.

**Three blocks, three columns.** If you want a genuine three-across layout with no thinking, use exactly three blocks and leave **Max columns** on Default.

***

### Related

* [Media overview](https://staylime.com/docs/avante-themes/sections/media.md)
* [Media with text](https://staylime.com/docs/avante-themes/sections/media/media-with-text.md)
* [Image grid](https://staylime.com/docs/avante-themes/sections/media/image-grid.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/sections/media/multicolumn.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
