> For the complete documentation index, see [llms.txt](https://docs.digia.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digia.tech/ui-building-blocks/widgets/content-display-widgets/story-video-player.md).

# Story Video Player

The **Story Video Player** lets you add autoplaying video content inside a Story item—similar to how videos work in Instagram or Snapchat stories. It’s designed for short, snackable clips that play seamlessly as part of your Story sequence.

### Use Cases

**Feature & Product Demos**

* Show how a feature works in 5–10 seconds
* Highlight key interactions (clicks, swipes, flows) in action
* Great for complex features that are easier to show than describe

**Promotional & Campaign Videos**

* Short promo reels, teaser videos, or brand films
* Limited-time offers or festival sale clips
* “Swipe through” video stories instead of static banners

**Tutorials & How-to Clips**

* Micro-tutorials inside your story sequence
* “How to use X” shown as a quick video step
* Combine with text/caption in header/footer for context

**Announcements & Release Highlights**

* Show new UI changes via screen recordings
* Animate before/after improvements
* Use video to bring release notes to life

### Core Concepts

The Story Video Player is typically used **inside the Items** section of the Story widget. Each Story item can contain a video player configured with its own behavior.

**Video Story Item**

* Renders a video as the main content of a single Story slide
* Can be full-screen or within a card/container
* Respects the Story widget’s flow (auto-advance, indicators, etc.)

**Playback Behaviour**

* Can auto-play when the story becomes active
* Can loop continuously or stop at the end
* Can be configured to fit the available space using BoxFit options

### Properties

| Property  | Description                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| Video URL | The source URL of the video to play inside the story. Usually a network URL (CDN, S3, or your own server).    |
| Auto Play | When enabled, the video starts playing automatically as soon as this story item becomes active.               |
| Looping   | When enabled, the video restarts from the beginning after it finishes, creating a continuous loop.            |
| Box Fit   | Controls how the video is resized inside its container (e.g., fill, cover, contain) while maintaining layout. |

### Default Properties

The Story Video Player widget supports all [Default Properties](/ui-building-blocks/widgets/default-properties.md).