> 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/stories-slideshow.md).

# Stories slideshow

Instagram-style circular thumbnails in Avante that open a full-screen, tap-through story with its own banners, buttons and tagged products.

Bring the familiar, tap-through feel of Instagram Stories to the storefront. Stories slideshow shows a row of circular thumbnails — "New in", "Sale", "Behind the scenes" — and tapping one opens a full-screen story where every slide has its own image, button and tagged products. It is a playful way to walk shoppers through drops, promos and collections without giving up a whole page to them.

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

{% step %}

#### Add a story

Use **Add block → Story** for each circle, up to seven. Upload its **Thumbnail image** and type a **Title**.
{% endstep %}

{% step %}

#### Fill in the banners

Inside the story, work down **Banner 1** to **Banner 8**. Each banner that has an **Image** becomes one slide, and can also carry a **Link**, a **Label** for its button, a **Button style** and a list of **Products**.
{% endstep %}

{% step %}

#### Save

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

{% hint style="warning" %}
Stories slideshow 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

**A story needs a thumbnail to exist on the live store.** Without a **Thumbnail image** the circle is not rendered outside the theme editor. In the editor it is always shown, with a placeholder, so you can keep building.

**A banner counts as a slide only if it has an image.** Banners are image-only — there is no video slot — and an empty banner is skipped. A story that has a thumbnail but no banner images still shows its circle, but the circle cannot be opened.

**Autoplay speed applies per slide.** The range is 3–20 seconds, and it starts at 8. That is the time one banner stays on screen before the story advances.

**Tagged products appear as cards under a heading you control.** The **Label** setting is that heading, and it reads "Products from promotion" until you change it.

<details>

<summary>Thumbnail settings</summary>

**Thumbnail border color** is the ring around each circle. **Thumbnail gradient color** replaces that solid ring with a gradient when it is set — the Instagram look.

**Border thickness** runs 0–6px and starts at 2. **Width** runs 64–120px and starts at 80; **Mobile width** runs 48–120px and starts at 64.

**Gap between items** runs 0–80px and starts at 40; **Mobile gap between items** runs 0–40px and starts at 20.

</details>

<details>

<summary>Product card content</summary>

**Price position** places the price above the title, on the same line, or below the card.

**Show vendor** and **Maximum product name characters** work as they do on every other product card in the theme.

**Show product rating** needs a review app that writes to the standard Shopify rating metafields — see [Product rating](https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-rating.md).

**Show short description** reads the Product subtitle metafield — see [Product subtitle (short description)](https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-subtitle.md).

**Show pickup availability** is off by default.

</details>

<details>

<summary>Overlay and section edges</summary>

**Overlay** is set to **Default**, which follows **Theme settings → Colors**. Switch it to **Custom** to set the overlay colour, its opacity and a background blur for this section's full-screen view.

**Left and right** chooses whether the section uses the store's default side padding (**Default**), drops it (**Disable**) or forces it on (**Enable**).

</details>

***

### Customization ideas

* **Use the gradient ring to signal "new"** and a plain ring for evergreen stories, the way social apps mark unseen content.
* **Tag products on every banner** so a story doubles as a shopping path rather than a slideshow.
* **Run one story per campaign** and retire it when the campaign ends — seven circles is a small amount of space, so keep it current.
* **Put the section just under the hero** on the home page, where the row of circles reads as navigation.

***

### Best practices

* Upload roughly square thumbnail images (around 1000×1000). They are cropped to circles, so keep the subject centred.
* Keep banner images vertical and text-light; they are shown full screen on a phone.
* Three to five banners per story is enough. At eight, the last ones are rarely reached.
* Check every story on the live store after publishing — a circle that will not open is a story with no banner images.

***

### Related

* [Shoppable media slider](https://staylime.com/docs/avante-themes/sections/media/shoppable-media-slider.md)
* [Product rating](https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-rating.md)
* [Product subtitle (short description)](https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-subtitle.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/stories-slideshow.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.
