Creating branches
How branches work: give every viewer their own path
Branches let one story show different content to different viewers. This article explains what a branch is, which types of branches you can choose from, and how to decide which one fits your story.
Who needs this: anyone who wants to tailor a story to its audience.
What is a branch?
A branch is a path in your story: a sequence of content blocks that a viewer only sees when they take that path. Every story starts with one Main branch.
You can add more branches to:
- create alternate paths for different audiences,
- reuse content across routes,
- organise your story in chapters,
- show content only after a viewer gave a certain answer.
Every option you give the viewer is a path. Say your content block has 4 options: then you have created 4 branches (A, B, C and D). When the viewer selects option A, they go to path A. Inside a branch you add content blocks just like you do in the main story.
What happens at the end of a branch?
After the last content block in a branch, you decide where the viewer goes next. You have three options:
- Continue to the next block: the viewer carries on with the story after the branch.
- Loop back to the branch choice: the viewer returns to the menu to explore another option. Branches the viewer already completed are marked, so they can see what is left to discover.
- Jump to another block: the viewer skips straight to a specific block in the story.
Example: a story starts with a menu (the branch choice) with several branches. The viewer picks one, watches one content block, and then loops back to the menu. In the editor, the orange line shows that "Loop back to branch choice" is selected after that block.
Which type of branch should I use?
There are four types of branches. Each one answers the question "who decides where the viewer goes?" differently.
Branch type | Who decides the path? | Best for |
|---|---|---|
Branch choice | The viewer, by picking an option | Menus, "choose your topic" moments, self-paced exploration |
Hotspot branch | The viewer, by tapping a spot on an image | Maps, floor plans, illustrated pick-a-path scenarios |
VR branch | The viewer, by looking at or tapping a target in a 360-degree view | Virtual tours, such as entrance, lobby, and then individual rooms |
Logic branch | The story, based on the viewer's earlier answers | Personalised outcomes, quizzes, tailored routes |
Branch choice
With a Branch choice, the viewer picks a path themselves by selecting an option. It looks like a multiple choice question, but the options are for navigation, not for scoring. Each option is its own branch.
Use it when you want to put the viewer in control.
Hotspot branch
A Hotspot branch works the same way as a Hotspot finder, but each hotspot leads to its own path. A hotspot is a clickable area in an image. When the viewer taps it, they go to that path. When they have seen it, you can send them back to the hotspot image to explore the other spots.
Use it for interactive maps, illustrated scenes or any moment where "tap what interests you" is more natural than a list of options.
VR branch
A VR branch works like a hotspot branch, but inside a VR or 360-degree environment. The viewer looks around, finds a clickable target and moves on to the next view or path. Use it for virtual tours where viewers move from space to space.
Logic branch (advanced)
A Logic branch chooses the path for the viewer, based on the answers they gave earlier. It is the option for more advanced builders and it is based on variables.
The Logic branch is a block the viewer never sees. Its only job is to send each viewer down the right path. For example: if score is higher than 10, go to the expert ending; otherwise, go to the beginner ending. You can combine multiple conditions for more complex routing.
How it works in short:
- Add content blocks that can store an answer in a variable, such as Multiple choice, Swipe cards or This or that.
- In the logic of those blocks, connect each answer to a variable and give it a value. For example: choosing option A on question 1 adds 1 to the variable team_creative.
- Add a Logic branch block after the questions and define which variable value leads to which branch.
- Add the content you want to show in every branch.
Plan your branches before you build
Sketch your flow first: where does the story start, which paths exist, and where do they come back together? Complex stories get confusing quickly, and a simple drawing on paper saves a lot of time in the editor. After publishing, the Flow view in your analytics shows which paths your viewers actually took.
FAQ & Troubleshooting
What is the difference between a branch choice and a logic branch? With a branch choice the viewer chooses the path. With a logic branch the story chooses the path based on earlier answers (logic), without the viewer seeing it.
How many branches can I add to one block? Every option is a branch. Add as many options as your story needs, but keep menus short enough to be easy to read on a phone.
Can I use branches inside branches? Yes, you can build nested branches. Keep an eye on the complexity and test your story with Preview.
Why does my viewer end up at the wrong place after a branch? Check the end-of-branch option of the last block in that branch: continue, loop back or jump to.
Can I send a viewer straight into a specific branch from a share link? Yes. With "Set variables" in your share link (when you create a share link you can set the variables directly), you can set a variable at the start of the story and let a Logic branch send the viewer to the right path. See Create an online share link for your story.
Updated on: 13/10/2026
Thank you!