# What is an element?
Elements are reusable content blocks in your story. They can represent objects, locations, documents or any other narrative element that you want to be able to insert in multiple places.
Concrete example
A mysterious letter that the reader finds in chapter 3 and can reread in chapter 7. Rather than duplicating the content, create a "Letter" element and reference it in both places.
# Structure of an element
| Field | Description |
|---|---|
| Name | Element identifier (e.g.: "The Count's Letter") |
| Internal description | A note to help you keep track |
| Image | Visual representing the element |
| Replacement mode | Behavior when displayed |
| Sections | Text content of the element |
# Sections
An element can contain multiple sections, each with its own formatted content. This allows you to structure complex elements.
- Multi-page document — Each section = one page
- Object with descriptions — Short description + detailed description
- Evolving location — Day description / night description / after an event
# Replacement mode
The replacement mode determines how the element is displayed in a step:
- Disabled — The element's content is added to the step's content
- Enabled — The element's content replaces the step's content
Replacement usage
Useful when the element IS the step, such as a journal page that the reader views in its entirety.
# Create an element
Access the elements
In the side menu, click on "Elements".
Create an element
Click on "Add an element".
Fill in the information
Name, internal description and replacement mode.
Add sections
Click on "Add a section" and write the content.
Upload an image
Optional: add a visual for the element.
# Link an element to a step
To display an element in a step:
- Open the step editor
- In the "Elements" section, click on "Choose elements"
- Select the elements to display
- Save the step
# Usage ideas
- Letters and journals — Documents discovered by the reader
- Location sheets — Descriptions of cities, dungeons, planets...
- Inventory objects — Swords, potions, keys...
- Investigation clues — Photos, testimonies, evidence
- Flashbacks — Memories unlocked as the story progresses