> 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/media-with-text.md).

# Media with text

One image or looping video beside a column of text blocks — Avante's general-purpose layout section, with video controls and background animation.

Most pages need the same thing more than once: one strong visual, a few lines that explain it, and a button. Media with text is that section. It pairs a single image or looping video with a content column built from the theme's common blocks, so the text side can hold anything from a plain paragraph to a collapsible FAQ, a promo code or a countdown.

{% hint style="info" %}
**Theme Editor → Add section → Media → Media with text**
{% endhint %}

***

### How to add

{% stepper %}
{% step %}

#### Open the template

In the Shopify admin, go to **Online Store → Themes → Customize** and open the template you want to edit.
{% endstep %}

{% step %}

#### Add the section

Click **Add section** and choose **Media with text**.
{% endstep %}

{% step %}

#### Add the media

Upload an **Image**, or pick a Shopify-hosted file under **Loop video**.
{% endstep %}

{% step %}

#### Build the content column

Use **Add block** to assemble the text side. A new section starts with a heading, a text block and a button.
{% endstep %}

{% step %}

#### Set the layout

Choose **Media size** and **Media ratio**, and turn on **Swap media position** if the media should sit on the left.
{% endstep %}

{% step %}

#### Save

Click **Save**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Media with text is a template section. It goes into page templates only — not into **More header sections** and not into the **Footer** group.
{% endhint %}

***

### Good to know

**One image or one video, not both.** The media slot takes either an **Image** or a **Loop video**. If both are filled in, the video wins and the image is never shown. Loop video plays a Shopify-hosted file; it is always muted and always loops.

**The section-level Link makes the whole card clickable.** Set **Link** in the section settings and the media and the text together become one link, with **Open link in a new tab** next to it. Buttons inside the content column keep their own links, so a card-wide link and a button pointing elsewhere can coexist.

**On mobile the media goes on top.** At 768px and below the two columns stack, media first. **Reverse order on mobile** — new in 16.0.0, off by default — flips that so the text comes first. It is a per-section setting because the right answer differs per section.

**An empty section disappears on the live store.** With no image, no video and no blocks, the section renders nothing outside the theme editor. In the editor it stays visible so you can keep working on it.

<details>

<summary>Layout settings</summary>

**Swap media position** is off by default, so the media sits on the right and the text on the left. Turn it on to mirror the layout.

**Media size** — **Large**, **50%** or **Small**. This is the share of the row the media takes, not a pixel width.

**Media ratio** — **Original** keeps the file's own proportions; the fixed ratios crop the media to a shape, which is what makes several sections on one page line up.

**Narrow content width** is on by default. It stops the text column from stretching across its whole half of the row, and is the reason the default layout reads comfortably.

</details>

<details>

<summary>Video controls</summary>

New in 16.0.0, and only relevant when **Loop video** is set.

**Enable pause control** and **Enable mute control** are both off by default, so the video plays silently with nothing drawn over it. Turn either one on and a **Horizontal position** setting appears, placing the controls **Left**, **Center** or **Right**.

</details>

<details>

<summary>Background animation</summary>

**Animation** starts at **Default**, which follows **Theme settings → Animation**. Choose **Customize** to override it for this section: **On scroll** offers **Parallax**, **Zoom in** and **Zoom out** — there is no Sticky option here — and each has its own mobile value.

See [Background animation](https://staylime.com/docs/avante-themes/features-and-advanced-setup/background-animation.md) for what the options do.

</details>

***

### Blocks

The content column accepts Subheading, Heading, Inline image reveal, Text, Collapsible tab, Button, Video button, Context image, Line, Empty space, Custom Liquid, Promo code and Countdown timer.

These are all shared blocks — see [Common blocks](https://staylime.com/docs/avante-themes/sections/overview.md#common-blocks) for what each one does, and [Collapse long text](https://staylime.com/docs/avante-themes/sections/overview.md#collapse-long-text) for the Text block's truncation option.

***

### Customization ideas

* **Swap the image for a looping video** when the product is better shown in motion — a bag being opened, fabric moving, a candle burning.
* **Alternate Swap media position** down a long page so consecutive sections mirror each other instead of repeating one layout.
* **Drop a Collapsible tab block into the column** to park sizing, care or shipping detail beside the visual without a wall of text.
* **Add a Countdown timer block** next to a campaign image and the section becomes a promo panel for the length of the sale.

***

### Best practices

* Keep **Media ratio** consistent across the Media with text sections on one page. Mismatched ratios are the usual reason a page looks unplanned.
* If you use the section-level **Link**, avoid two buttons with different destinations in the column — shoppers cannot tell which one the card obeys.
* Check the mobile stack before publishing and decide per section whether the visual or the heading should come first.
* See [Image & video size recommendations](https://staylime.com/docs/avante-themes/faq/performance/image-and-video-size-recommendations.md) before uploading: file weight matters more than exact pixel dimensions.

***

### Related

* [Media with side tabs](https://staylime.com/docs/avante-themes/sections/media/media-with-side-tabs.md)
* [Background animation](https://staylime.com/docs/avante-themes/features-and-advanced-setup/background-animation.md)
* [Common section settings](https://staylime.com/docs/avante-themes/sections/overview.md#common-section-settings)


---

# 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/media-with-text.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.
