> 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/shoppable-media-slider.md).

# Shoppable media slider

A reels-style carousel of vertical images and videos in Avante, where each slide carries its own product card with price, vendor and add to cart.

Sell straight from the scroll. Shoppable media slider turns vertical images and videos into an immersive, reels-style carousel — each slide pairs eye-catching media with a product card, so shoppers can add to cart without leaving the section. It is the closest thing to social-style shopping built into the storefront itself.

{% hint style="info" %}
**Theme Editor → Add section → Media → Shoppable media slider**
{% 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 **Shoppable media slider**.
{% endstep %}

{% step %}

#### Add a slide

Use **Add block** and pick **Product** for a shoppable slide or **Text** for a promo slide.
{% endstep %}

{% step %}

#### Give the slide its own media

In the block, upload an **Image** or pick a **Video**. On a Product block, also choose the **Product**.
{% endstep %}

{% step %}

#### Repeat and save

Add the rest of the slides the same way, then click **Save**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Shoppable media slider 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

**Slide media does not come from the product.** Every block needs its own **Image** or **Video**, uploaded in the block itself. On the live store a slide with no media of its own is not rendered at all, and a Product block also needs a product selected. In the theme editor every block stays visible, so if a slide looks fine while you are editing and vanishes after publishing, the block is missing its image or video. If both an image and a video are set, the video is used.

**Center slides is a looping setting, not an alignment one.** The active slide is always centred. What **Center slides** actually does is make the carousel loop endlessly, and it only works when there are more slides than fit on screen at once plus one — the editor says as much: *Works only if the section contains enough blocks to loop the slider*. Turning it off does not make the slider start flush left.

**Only the active slide plays.** Video on the neighbouring slides is paused, so a long carousel of video slides does not turn into a dozen videos playing at once.

**Text blocks are promo slides.** A Text block has no product. It takes an **Image** or **Video**, a **Number** (set it to 0 to hide it), a **Title** and **Text**, plus a **Link** — new in 16.0.0 — that turns the slide media into a link.

<details>

<summary>Blocks</summary>

**Product** — one shoppable slide. Settings: **Product**, **Image**, **Video**, and **Link media to product page** (new in 16.0.0, off by default), which makes the slide media a link to the product page. The product card — vendor, price, add to cart — sits under the media.

**Text** — a promo slide with no product. Settings: **Image**, **Video**, **Link** (new in 16.0.0), **Number**, **Title** and **Text**.

</details>

<details>

<summary>Media settings</summary>

**Image ratio** sets the shape of the slide: **Portrait (4:5)**, **Narrow portrait (2:3)** or **Vertical (9:16)**, which is the default and the one that reads as reels.

**Corner radius** rounds the slide corners; it starts at 12px.

**Enable pause control** and **Enable mute control** are both on by default in this section, and **Horizontal position** — new in 16.0.0 — places those buttons **Left**, **Center** or **Right**.

</details>

<details>

<summary>Product card settings</summary>

**Image ratio** and **Focal point** control the product thumbnail on the card, independently of the slide shape.

**Show vendor**, **Show price** and **Enable 'Add to cart' button** are all on by default.

**Maximum product name characters** trims long titles; set it to 0 to hide the product name entirely.

</details>

***

### Customization ideas

* **Alternate Product and Text slides** so the carousel reads as a story — a product, a promo card, the next product. The default preset is built exactly this way: four Product slides with three Text slides between them.
* **Number the Text slides** (1, 2, 3) to turn the section into a styled how-it-works strip between shoppable slides.
* **Turn on Link media to product page** when the card is already busy and you want the whole visual to be the tap target.
* **Reuse your social cuts.** Vertical clips made for Reels or TikTok drop straight into the 9:16 slide.

***

### Best practices

* Shoot or crop media vertically. Anything else will be cropped to the slide ratio.
* Add enough slides for looping to work before you turn **Center slides** on — four or more is a safe starting point.
* Compress video hard. A carousel is several files on one page; see [Image & video size recommendations](https://staylime.com/docs/avante-themes/faq/performance/image-and-video-size-recommendations.md).
* After publishing, open the live page and count the slides. A missing one is almost always a block with no media.

***

### Related

* [Stories slideshow](https://staylime.com/docs/avante-themes/sections/media/stories-slideshow.md)
* [Image & video size recommendations](https://staylime.com/docs/avante-themes/faq/performance/image-and-video-size-recommendations.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/shoppable-media-slider.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.
