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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digia.tech/ui-building-blocks/widgets/content-display-widgets/story-video-player.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.