For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

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.

Theme Editor → Add section → Media → Stories slideshow


How to add

1

Open the template

In the Shopify admin, go to Online Store → Themes → Customize and open the template you want to edit.

2

Add the section

Click Add section and choose Stories slideshow.

3

Add a story

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

4

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.

5

Save

Click Save.


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.

Thumbnail settings

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.

Product card content

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.

Show short description reads the Product subtitle metafield — see Product subtitle (short description).

Show pickup availability is off by default.

Overlay and section edges

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).


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.


Was this helpful?