Stories, scenes, choices and endings
Contents
A Bitebox story is a graph: nodes hold its parts, and wires connect them. Canvas and your assistant change the same story. Understanding its routes helps you see where a viewer can go and where the story stops.
How it works#
A scene is playable media, such as a clip. A story route connects one part to the next. A port is a connection point on a node. Each wire connects an output port, which sends, to an input port, which receives. A story route may lead back to an earlier scene, so two clips can play each other in turn. A loop must pass through a scene. The player passes Set, If, Router and editing nodes without stopping, so a loop made only of those nodes is refused. The editing nodes are Rotate and Flip, Invert, Trim, Crop, Resize, Color correction, Composite, Add Audio and Extract Audio. When play lands on an editing node, for example when a viewer resumes there, the player shows nothing for it and plays the next scene on its route. Prompt, position, pulse and signal wires cannot loop.
A choice lets the viewer select a route. The choice-overlay belongs to a clip and gives each option its own Storyline output. For example, a station scene could offer “Take train” and “Stay here.” Each option leads forward to a different scene. Those scenes can continue the story or end it.
A clip's Storyline output has one destination. To keep the scene that plays next and also put targets on the clip, select Add branch on the clip once for each hotspot. Connect each new branch to one target. The player shows every target on the clip, a tap follows that target's route, and the clip plays on to its next scene when nobody taps.
A branch with nothing connected does nothing. The story plays on past it, and the clip can still be an ending. Canvas marks the branch as a problem until you connect or remove it, and you can still publish.
A Storyline wire on an input that takes no Storyline, such as a Pulse input, is not a route. Canvas keeps the wire and marks it as a problem, so you can move it to a Storyline input. Until you move it, the clip ends there. In a story saved before November 6, 2026, the same wire stops the story at that clip, so move it or delete it.
To change scenes at a set moment, select Add branch on the clip and connect the new branch to a timer. Select the timer, enter the moment in Timecode, and connect its output to the next scene. The story moves on when the clip reaches that moment. To remove a branch, select Remove next to it on the clip.
A detour is a route the viewer can return from during play. When a viewer takes a choice-overlay option, the player saves the scene they left and its playback position. Back returns to that scene at the saved position. A story route into a scene always plays it from the start, also when a loop comes back to a scene the viewer left. This return uses playback history; you do not wire the detour back to its caller.
An ending is where a story path stops. A story does not need an ending: it can loop instead, and it can still be published. Terminal scenes reached from the start count as endings. A terminal scene has no outgoing story route: no wired next route, owned overlay, or incomplete choice option. An empty Storyline exit (an autoplay exit with no destination) does not stop a scene from being an ending: the scene plays to its end and the story ends there. An incomplete exit or option has no destination yet.
A tile that generates media during play is excluded from this terminal-scene rule. The story can have several endings. The main ending can have an explicit marker; other terminal scenes need no extra marker.
In the station example, both destination scenes can be endings if neither has a route out. An unwired choice option is different: it leaves a route incomplete, rather than creating an ending.
When to use it#
Use scenes to present the story and choices to offer different routes. Use a detour when the viewer should be able to return to the scene they left. Wire a route back to an earlier scene when that part of the story should repeat. Check that the viewer can reach your intended endings or loops from the start.
Ask your agent#
Explain my story's scenes, choices, detours and endings. Inspect it first and show where each route ends or loops back.
Check the explanation against your story in Canvas.
Try it#
Follow the Builder guide to inspect, wire, validate and play your story.