> 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-side-tabs.md).

# Media with side tabs

Up to five tabs that each swap the media beside them — images, YouTube or Vimeo videos, or looping Shopify files, loaded only when a shopper reaches for them.

When one visual is not enough but a slider is too much, Media with side tabs lets a shopper choose. A list of headings sits beside a single media frame; clicking a heading swaps what is shown. It suits a feature walkthrough, a how-it-works explainer or a set of materials — anything where each point deserves its own picture but the points belong together.

{% hint style="info" %}
**Theme Editor → Add section → Media → Media with side tabs**
{% 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 side tabs**. It arrives with one tab of each type.
{% endstep %}

{% step %}

#### Set up each tab

Open a tab block and fill in its **Heading**, **Text** and media. Add a **Button label** and **Link** if the tab should lead somewhere.
{% endstep %}

{% step %}

#### Add or remove tabs

Use **Add block** to add an **Image**, **Video** or **Loop video** tab, up to five in total. Drag them to set the order.
{% endstep %}

{% step %}

#### Save

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

{% hint style="warning" %}
Media with side tabs 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 block is one tab, and the block type decides the media.** There are three: **Image** takes an image. **Video** takes a YouTube or Vimeo URL shown behind a **Cover image**, with an optional **Mobile cover image** — the player itself only loads when the visitor clicks the cover. **Loop video** takes a Shopify-hosted file that plays muted on a loop. The section holds up to five tabs.

**The first tab is open on load, and nothing rotates by itself.** Clicking a tab heading switches the media. There is no autoplay and no timer, so a shopper decides how long to look at each one.

**The other tabs are not loaded until they are needed.** Media for tabs two to five loads when the visitor hovers or focuses that tab, which is why a five-tab section costs about as much as a one-image section on first paint.

**Swap media position is on by default here.** Out of the box the media sits on the left and the tab list on the right — the opposite of [Media with text](https://staylime.com/docs/avante-themes/sections/media/media-with-text.md). Turn the setting off to put the media back on the right.

**No video controls and no mobile reordering.** Unlike Media with text, this section has no pause or mute buttons for its looping video, and no **Reverse order on mobile** setting.

<details>

<summary>Tab content settings</summary>

Each tab carries its own **Heading**, with a **Solid** or **Gradient** colour option, and its own **Text**. Long text can be shortened with **Collapse long text** — see [Collapse long text](https://staylime.com/docs/avante-themes/sections/overview.md#collapse-long-text).

The button is optional: leave **Button label** empty and no button is drawn, whatever the link says.

</details>

<details>

<summary>Headings and SEO structure</summary>

The section **Subheading** sits above the tab list and introduces the whole group.

**Tab heading** has its own size setting and its own **Tag** — **H1**–**H6**, **div**, **span** or **p**. The tag is what search engines read, so on a page where these tabs are the main content give them a real heading level, and on a page that already has an H2 above them drop them to a lower level or to `div`.

</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**, each with 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>

***

### Customization ideas

* **Mix the block types in one section** — a photo for the material, a looping file for the product in use, a YouTube review for proof.
* **Write headings as questions** so the tab list reads like a short FAQ and the shopper knows what each tab will answer.
* **Give one tab a button and leave the others without one** to steer attention to the single action you care about.
* **Use it on a landing page as a feature tour**: four tabs, four screenshots, four sentences.

***

### Best practices

* Three or four tabs is usually the sweet spot. Five fit, but the list starts to compete with the media for attention.
* Pick a fixed **Media ratio** if your tab media come in different shapes — every tab is then cropped to the same frame. With **Original**, each tab keeps its own proportions and the section changes height as shoppers switch tabs.
* Keep headings short enough to stay on one line on mobile.
* For **Video** tabs, always upload a **Cover image**. There is no fallback to the YouTube or Vimeo thumbnail — without a cover the tab shows the theme's placeholder illustration until the visitor clicks it.

***

### Related

* [Media with text](https://staylime.com/docs/avante-themes/sections/media/media-with-text.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-side-tabs.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.
