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

# ⬜ Story

# ⬜ Story

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

![Story](https://celestory-docs-illustrations.netlify.app/en/Story_EN.svg)

The Story block displays a narrative text to the player, even a long one (several paragraphs), all at once.

It's the simplest tool for telling a piece of story: unlike the Narrator block, which shows one short line at a time, the Story block saves you from splitting a long text into a long chain of small blocks connected on the canvas.

## 📥 Inputs

- text (Multiline Text): The story text to show the player. It can contain several paragraphs.

## 📤 Outputs

- out (Stream): Activates once the text has been shown, to continue with the rest of the flow (another Story block, a Choice, a change of scenery, etc.).

## 💡 Example of use

Scenario: Introducing a village at the start of the game

1. The player arrives in a village for the first time.
1. A Story block is placed on the canvas to set the scene.
1. In the text field, the designer writes a short multi-paragraph passage, for example:

   "The village of Stonevale still sleeps under the morning mist.

   Wary of strangers, its people quickly shut their windows as you pass by."

1. The text appears on screen, and the player reads it at their own pace.
1. Once the reading is done, the out output activates and the flow continues to a Choice block or a new scene.

## ⚙️ Technical Details

- This block has a single multiline text field: there is no internal editor for managing several lines, characters, or backgrounds within one Story block. For a scene that alternates between several speakers or background changes, chain several blocks instead (Narrator, Dialogue, Background image, etc.).
- Usage recommendation: Prefer this block over Narrator when you need to display a long passage of text all at once, without splitting it into several lines.

---

*Documented version: v1*