> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟪 Video choice

# 🟪 Video choice

${frame}[Video: anatomy of the Video choice block](https://celestory-docs-videos.netlify.app/en/anatomie-bloc/displaychoice.html)

![Video choice](https://celestory-docs-illustrations.netlify.app/en/Videochoice_EN.svg)

The Video choice block presents the player with a set of choices overlaid on a playing video — typically used in the Chatbot and Visual Novel templates for cinematic decision points.

## 📥 Inputs

- in (Stream): Entry point that triggers the display of the choices over the video.
- choices: The list of text options offered to the player (add one or more "Text" entries).
- timer (default: 0): Optional countdown before a default choice is made automatically (0 = no timer).
- appear before end (default: 0): Lets the choices appear before the video finishes playing, by the given amount of time.
- content: The video to play behind the choices.
- can zoom (default: false): Whether the player can zoom into the video.

## 📤 Outputs

- One dynamic output per choice, activated when the corresponding option is selected.

## 💡 Example of use

Scenario: A branching cutscene

1. The content input plays a short cinematic clip.
2. Two choices are added, set to appear 2 seconds before the video ends ("appear before end").
3. The player picks an option before or right as the video finishes, and the flow continues from the matching output.

## ⚙️ Technical Details

- Template-specific block: Video choice is available in the Chatbot and Visual Novel templates rather than the generic block registry.
- Related blocks: see also the generic Choice and Audio choice blocks.

---

*Documented version: v1*