📘 Vesperia documentation

Theme docs

Homepage sections

Video carousel (story videos)

A horizontal carousel of vertical reels that open into a fullscreen lightbox — Instagram Stories for your storefront.

Add it

Customize → Add section → search “Video carousel”. The internal section file is named story-videos.liquid.

Per-video block

  • Upload video (Shopify-hosted) — the recommended path. Direct .mp4 upload; the poster image is auto-generated from the first frame.
  • External video URL — fallback: a direct .mp4 link from Shopify Files or a CDN.
  • Poster image (optional) — override the auto thumbnail. Leave empty to use the video first frame.
  • Title / caption — displayed in the lightbox overlay.
  • Linked product — attaches a “Shop” card inside the lightbox pointing to that product.
  • CTA label — button text (“Shop this product” default).

Section settings

  • Eyebrow + Heading + Subheading.
  • Heading size — H1 / H2 / H3.
  • Tile aspect ratio — 9:16 portrait (Instagram reel) / 3:4 / 1:1 / 4:5.
  • Show navigation arrows — prev/next on desktop.
  • Show pagination dots.
  • Show caption on card — displays the video title under the tile.
  • Autoplay video when lightbox opens — muted autoplay (browser policy).
  • Loop video in lightbox.

The lightbox

Clicking a tile opens a fullscreen modal:

  • Video auto-plays muted. The mute / unmute toggle is at bottom-right.
  • Close X at top-right.
  • Vertical progress bars on the left show position in the playlist. Click any bar to jump.
  • Arrow keys / on-screen prev-next / swipe up-down to navigate between videos.
  • The “Shop” card (if a product is linked) sits at the bottom with image + price + CTA.
  • Escape closes the lightbox.

Tips

  • Keep each video under 15 seconds for max engagement.
  • 9:16 vertical is the most editorial format — record in portrait mode.
  • Repurpose existing Instagram Reels here — they’re already the right format.

Made with Emergent