🟦 AI
⬜ AI image request
The AI image request block allows you to convert textual descriptions into dynamically generated images via integrated Artificial Intelligence models (fal.ai). It transforms narratFew readers⬜ AI text request
The Text AI Query block allows you to connect a scenario to text-based AI models (LLM) to generate dynamic and contextual responses, providing fluid and personalized interactivity.Few readers
⬜ Comments
⬜ Story
The Story block displays a narrative text to the player, even a long one (several paragraphs), all at once.Some readers⬜ Connector
The Connector block allows you to merge several paths in a graph to unify the flow towards a common scenario or to visually air out the graph by avoiding tangled connections.Some readers⬜ Comment
The Comment block allows you to add notes, explanations or reminders visible only in the editor, without impacting the execution of the project.Some readers
🟩 User Interaction
🟦 Dialogue
The Dialogue block allows you to display a series of messages sent by one or more characters, with media management and dynamic variables, to create rich conversations in narrativePopular🟩 Start
The Start block allows you to define the absolute launch point of any Graph, Scenario or Celestory Module. It represents the starting line of logical execution and is essential forPopular🟩 Load video
Example link: https://creator.celestory.io/project/OqkScT5D5 The Load video block allows to create a video value which can then be sent to another block via a constituent point. It allows to use the url of a video (direct link) to display it in the user interface. To display a video player, like YouTube, read this article: https://documentation.celestory.io/en/article/insert-a-youtube-video-1horjlj/ Here we have indicated the direct link of the video in the url field of the block. ![Some readers🟦 Clear feed
The Clear feed block wipes the screen of messages that are already displayed, so the story can start fresh on a "clean" page. It is mainly useful in modules where messages pile up Some readers🟦 Narrator
The Narrator block allows you to simulate real-time writing of messages ("typewriter" effect), adding dynamism and realism to dialogues in a Chatbot or Messaging format.Some readers🟦 Notification
The Notification block allows you to notify the user of an event without interrupting their experience or requiring interaction. It displays a brief message or icon on the screen, Some readers🟦 Image
The Image block allows you to display a simple image in the flow of your application or chatbot, generally accompanied by optional descriptive text. Ideal for illustrating an objecSome readers🟩 Input number
The Input Number block asks the player for a number, using a simple input field.Some readers🟩 Video
The Video block allows you to display an image or video media file in full screen. By clicking on it, the player makes it disappear and the stream continues. If the Enable Zoom function is activated, then it will be possible to zoom in on it, and to pass, the player will have to click on the cross at the top right of the player.Some readers🟦 Choice with dialogue
The **Choice with dialogue** block allows you to display a series of dialogue messages, then, once it is finished, pause the experience to offer choice buttons to the user. It is eSome readers🟦 Load image
The **Load image** block lets you fetch an image hosted somewhere on the internet (via its URL) and use it directly in your Celestory story, without needing to import it into your Some readers🟩 Input text
The Input text block lets the player type some text, for a dialogue, a riddle, or a sign-up.Some readers🟩 Input
The Input block shows a small field where the user can type in a piece of information, directly inside the Celestory interface, without opening a separate window. This avoids breakSome readers🟦 Link
The Link block allows you to instantly redirect the user to an external web page (URL) from a Celestory application.Some readers🟦 Background image
The Background Image block lets you prepare an image to be used as a background: how it should fit the screen, whether it repeats as a pattern, and where it sits.Few readers🟦 Get URL from Image
The Retrieve Image URL block allows you to extract the textual URL of an "Image Resource" object from Celestory for external use.Few readers🟦 Microphone
The Microphone block allows you to record the voice or sound coming from the user via the microphone of their device (computer or smartphone).Few readers🟦 Load sound
The **Load sound** block lets you fetch a sound hosted somewhere on the internet (via its URL) and use it directly in your Celestory story, without needing to import it into your pFew readers🟦 Get URL from file
The Recover File URL block allows you to convert a "File" object managed by Celestory into a text URL that can be used for external interactions.Few readers⬜ Select file
The Select file block allows you to trigger the opening of the device's file picker (browser or native OS) to let the user import one or more files from their device into the CelesFew readers🟩 Multi Input
The Multi Input block shows several input fields at once, in a single form, instead of asking for one piece of information after another.Few readers
🟧 Media & Scene
🟧 Switch Background
The Switch background block allows you to change the background, the decor of the module, from another image from the Resources. The block allows you to operate on a wide spectrum of parameters. For example, you can change the position, the size, the color of the rest of the screen or the description of the image. Indeed, the background will be displayed for a short amount of timPopular🟧 Play music
The Play music block allows you to launch an audio track in the background, ideal for background music or continuous sound loops.Some readers🟧 Edit character
The Modify character block allows you to dynamically update the attributes and visuals of a character during the execution of the application (e.g. chatbot), without having to recrSome readers🟧 Stop music
The **Stop music** block immediately stops any background music currently playing, for example to end an ambient soundtrack before starting a new scene.Some readers🟧 Play sound
The Play sound block triggers a one-off sound effect, noise, or voiceover in your application.Some readers🟧 Background
The Background block allows you to dynamically change the visual background of an app or story, applying images, solid colors, or text with customizable transition effects.Few readers🟧 Input Camera
The Input Camera block lets the player take a photo with their device's camera, directly inside the story. It's a simple way to add a visual interaction, no coding needed.Few readers⬜ Video from URL
The Video from URL block lets you use a video that stays hosted on another site (for example your own server), instead of importing it into your Celestory project. You simply give Few readers🟧 Scene
The Scene block lets you set up the backdrop for a moment in your Visual Novel: a background image, a number of slots for placing characters, and a number of layers to give the disFew readers⬜ Load media from URL
The Load media from URL block allows you to retrieve media (image, video or sound) hosted on the internet via a URL to use it in Célestory without having to store it locally.Few readers⬜ Video Display
The Video Display block lets you show, in full screen, an image or video imported into the project's internal resources. It is ideal for integrating cinematic sequences, tutorials,Few readers
🟪 Narrative behavior
🟪 Unique choices
The **Unique choices** block lets you present a list of options to the user, just like the standard Choice block, but it automatically removes from the list any option already pickPopular🟩 Choice
The Choice block allows you to pause an interactive experience and present buttons for the user to make a decision. The rest of the flow will depend on the button clicked, thus makSome readers🟪 Alter choice
The Modify choice block allows you to create dynamic menus by altering in real time the response options (buttons) offered to the user. It plugs as a configuration value into an opSome readers🟪 Video choice
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 pointSome readers🟪 Swipe
The Swipe block allows you to display an interactive interface in the form of a card (Tinder or Reigns style) where the player makes a decision by swiping the screen to the left, rSome readers🟪 Alter clickable zone
The Modify Clickable Area block allows you to dynamically modify the state, appearance or activation of a clickable area in a visual block (like Graph blocks).Some readers🟪 Pause
The Pause block allows you to pause the execution of the flow for a defined duration before continuing with the next action.Few readers🟪 Generate JSON
The Generate JSON block combines several of your variables (text, numbers, lists, Booleans) into a single organized block of data, in "JSON" format: a standard way of writing strucFew readers🟪 Date check
The Date Check block automatically compares the current date and time (fetched by the block itself — nothing to connect for that) to a reference date you choose, to find out whetheFew readers🟪 Audio choice
The Audio choice block presents the player with a set of choices centered on an audio clip, optionally illustrated by an image — typically used in the Chatbot template to let a chaFew readers🟪 Voltask Webhook
The Voltask Webhook block allows you to create a direct technological bridge between Celestory and Voltask by sending an HTTP request to this external system, to trigger back-end aFew readers🟪 QTE
QTE stands for "Quick Time Event": this block creates a fast, timed challenge where the user must act quickly (for example, tapping the screen several times) before a timer runs ouFew readers🟪 Clickable zone
The Clickable zone block turns a picture into several invisible buttons: you mark out areas on an image (for example "Play", "Options" and "Quit" buttons drawn on a background) andFew readers
🟥 Flow Control
🟥 Condition
The Condition block allows you to create a logical referral by asking a closed question ("True or False?"). Depending on the answer, the story flow takes the true or false branch, Popular🟥 Break
The Break block makes a tiny pause, invisible to the player, in the middle of a loop (a sequence of actions that repeats several times in a row).Some readers🟥 Sequence
The Sequence block allows you to distribute a flow to several outputs in a sequential and cyclical manner. Each time it is activated, it activates the next output in the defined orSome readers🟥 Once
The Once block lets a flow through only once: as soon as a signal has passed through it, it closes itself automatically and blocks any signal that follows, a bit like a single-use Some readers🟥 Word recognition
Example link: https://creator.celestory.io/project/XsIFyE3mE The Word Recognition block recognizes text expressions. Coupled with a Text input block, it allows to recognize text typed by the user. Once the block is created on the graph, you can click on the Words button to add expressions that the block will recognize. You can add several expressions per field, to doSome readers🟥 Random path
The Random Path block picks one of the paths you've prepared in your story, at random. This is what creates surprise: a player who opens the same chest twice might find treasure thSome readers🟥 Repeat
The Repeat block lets you repeat an action or a flow a set number of times, one after another (the equivalent of a "for" loop in programming).Some readers🟥 Switch
The Switch block allows you to check a series of conditions in parallel and route the flow to the first branch whose condition is true, thus avoiding the stacking of "Condition" blFew readers⬜ No Reverse
The **No / Invert** block allows you to invert a Boolean value (True/False).Few readers⬜ Words recognition
The Word recognition block lets you spot certain words in text typed by the player, and trigger a different action depending on which words are found.Few readers
⬛ User interface (UI)
⬜ Run Javascript
The Run Javascript block allows you to execute a custom JavaScript script within a Celestory module, offering the possibility of manipulating data, performing complex calculations Some readers⬜ Alert
The Alert block allows you to display a text message with simple formatting (bold, italics, links...) and an optional image. This kind of formatting is called "Markdown"; you don'tSome readers⬛ Set HUD (Head UP Display)
Link to the graph example: https://creator.celestory.io/project/1VqMc5WsZ Link to the video example: https://www.loom.com/share/7e9c5eb9af1147e48fe0029082889897 ⬛ Set HUD (Head UP Display): The Head Up Display (HUD) allows you to display a persistent menu and its items in the upper part of the screen during the user experience. To create a HUD, you must first goSome readers⬜ Hide HUD
The Hide ATH block allows you to temporarily or permanently hide the user interface (ATH/HUD) of a module, such as menus, navigation buttons and other overlay elements.Some readers⬜ CSS
CSS is a language used to change the visual appearance of an element (colors, shapes, sizes, animations) — a bit like choosing the formatting of a text, but with many more possibilSome readers⬜ HTML5
The HTML5 block allows you to integrate and display tailor-made HTML code directly in a Celestory application. It provides the ability to design custom interfaces, buttons or interFew readers⬜ Open menu
The Open Menu block allows you to dynamically display a preconfigured menu interface in your Celestory project, such as a main menu, an inventory or a custom popup.Few readers⬜ Set HUD
The Set HUD block displays a HUD (Head-Up Display) on screen: a permanent interface shown during play, such as a health bar or a score counter, overlaid on top of the current sceneFew readers
🟨 Navigation
🟨 Open a graph
The Open a graph block lets you jump into another graph (another piece of your story or logic) — a bit like opening a different chapter, then coming back later to where you left ofSome readers🟨 Open module
The Open a module block allows you to navigate to the highest level of the tree structure of your Celestory project: change the Application Module altogether.Some readers
🟦 Data Processing
⬜ Airtable
The Airtable block allows you to connect your Celestory project to an Airtable database to read, modify, add or delete data. It is particularly useful for managing structured inforPopular🟦Text Format
Blocks containing a text stack now have the same capacity as the Text Format block. Therefore, all of the next description is also correct for these blocks. The Text Format block is a block which allows you to replace certain variables (to be indicated by an unknown between singletons {{ }} which will create a point with the name of this unknown to be linked to the block of the corresponding variable). These variables can be numeric or textual, and will be replaced by their current value in thePopular🟦 Decrement
The Decrement block allows you to subtract a precise value from a Number type variable, providing a convenient shortcut for operations like removing life points, decreasing a countPopular🟦 Random number
The Random number block allows you to generate a random numerical value between two user-defined limits. It is essential for introducing randomness into experiences, such as game mSome readers⬜ Checkpoint
The Checkpoint block automatically saves where the player is in the story (their position and their variables), at that exact moment.Some readers⬜ Add to list
The Add to list block allows you to add a new element at the end of an existing list. It is essential for managing collections of objects, choice histories or any group of dynamic Some readers⬜ Make
The Make block allows you to send data from your Celestory application to a Make scenario, thus connecting Celestory to thousands of external applications (sending emails, writing Some readers🟦 Webview
The Web View block allows you to integrate and display a web page directly in the conversation feed of your Celestory application (as a frame embedded in the flow), without redirecSome readers🟦 Assign
The Assignment block allows you to modify the value of a variable during an experiment. It is essential for dynamically updating data like a score, counter or any other informationSome readers🟦 List includes
The List contains block allows you to check if a specific element (text, number or boolean) is present in a given list.Some readers⬜ Analytics
The Analytics block allows you to record an invisible event in Celestory statistics to track user behavior. It acts as a discreet marker that helps analyze journeys, identify drop-Some readers🟦 Expression
The Expression block allows you to perform mathematical calculations or logical evaluations based on a custom formula. It acts as an advanced calculator or validator for complex coSome readers🟦 Todays date
The Today's Date block allows you to retrieve the current date at the precise moment when the player passes through this block. It is particularly useful for timestamping an event,Some readers⬜ Zapier
Zapier is an online service that automatically connects thousands of apps together (Gmail, Slack, Google Sheets, Discord, Airtable, etc.), with no coding needed. The Zapier block lSome readers🟦 Increment
The Increment block allows you to increase the value of a numeric variable by a defined amount. It is particularly useful for managing scores, counters or resources in interactive Some readers🟦 Remove from list
The Delete from list block allows you to remove a specific element from a List (Array) type variable. It is essential for managing inventories, shopping carts, task lists or groupsSome readers🟦 Get from list
The Retrieve from a list block allows you to precisely access an element stored in a collection (list/array) by specifying its index.Some readers⬜ Load checkpoint
The Load Backup block allows you to restore the user's progress from a previously saved backup.Some readers🟦 Not
The Not block flips a Boolean value (True/False): True becomes False, and False becomes True — like a switch that reverses itself.Some readers🟦 Multiple assign
Multiple assignment is a block that lets you assign several values to several variables (which can be of different types, such as numeric or textual) at once, saving you time.Few readers🟦 Loop through a list
The Loop through a list block allows you to iterate over each element of a list to process them individually, like a Foreach loop in programming.Few readers⬜ Decode JSON
The Decode JSON block allows you to transform data in JSON text format (often from API or Webhooks) into individual variables that can be used in other Celestory blocks (Text, NumbFew readers🟦 Format text
The Format text block allows you to generate dynamic sentences by integrating variables into a model text (eg: "Hello {{First name}}, you have {{Score}} points").Few readers⬜ Multi Assign
The Multiple Assignment block allows several variables to be modified simultaneously in a single block, thus avoiding the repeated use of individual assignment blocks. Ideal for reFew readers🟪 JSON to Object
The JSON to Object block converts a text string in JSON format (for example received from an API or a Webhook) into an actual Object variable, directly usable by Celestory's other Few readers🟪 Object to JSON
The Object to JSON block converts an Object variable (a "record" holding several pieces of information) into JSON-formatted text — a format most websites and online services can reFew readers🟪 Set in Object
The Set in Object block lets you add or update a property in an Object variable. An "Object" here is simply a variable that groups several related pieces of information under one nFew readers🟪 Loop through Object
The Loop through Object block lets you automatically iterate over every property (key/value) of an Object variable, one at a time.Few readers🟪 Get from Object
The Get from Object block lets you read a specific value stored inside an Object variable (structured key/value data, like a JSON object).Few readers🟪 Remove from Object
The Remove from Object block lets you remove a specific property (key/value) from an Object variable.Few readers🟪 HTTP Request
The HTTP Request block lets you call an external web service that offers an API, directly, without going through a ready-made integration (Airtable, Baserow, Zapier...). It handlesFew readers🟪 Destructure Object
The Destructure Object block lets you pull out every property of an Object variable at once, each to its own output, instead of chaining several "Get from Object" blocks.Few readers