> For the complete documentation index, see [llms.txt](https://help.blings.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blings.io/apps/blings-studio/connectors/branch-timeline.md).

# Branch Timeline

Use Branch Timeline when a viewer action should send the experience to another scene or timeline path. This connector supports interactive stories, choice-based flows, quizzes, product paths, and alternate narrative routes.

<figure><img src="/files/ejWQrAAE9ZZVm79dJil8" alt="Studio Connect mode with connector list, scene canvas, and right-side scene context used when configuring routing connectors"><figcaption></figcaption></figure>

## Options

| Option                        | What it controls                                                         | Notes                                                                   |
| ----------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| **Trigger layer**             | The clickable or interactive layer that chooses the branch.              | Use a clear button, hotspot, or interactive element.                    |
| **Target scene**              | The scene that should play after the interaction.                        | Confirm the scene exists and starts at the intended moment.             |
| **Entry point**               | The exact point in the target scene or timeline path.                    | Use when the branch should enter after an intro or at a specific frame. |
| **Timeline sequence**         | The new scene order after the branch.                                    | Validate the full path, not only the first target scene.                |
| **Duplicated scenes**         | Alternate scenes created for different branch outcomes.                  | Duplicate only when the branch needs different content or timing.       |
| **Data or expression source** | Optional logic that chooses a branch from data or code.                  | Use when the path depends on viewer data instead of a direct click.     |
| **Fallback path**             | The path used when no branch is selected or the source value is invalid. | Keep a default route so the experience can continue.                    |

## Configure a Branch

{% stepper %}
{% step %}

### Define the Branch Outcome

Decide what each viewer choice or data state should lead to before editing the connector.
{% endstep %}

{% step %}

### Select the Trigger Layer

Choose the layer that represents the viewer action, such as a button for `Dogs` or `Cats`.
{% endstep %}

{% step %}

### Set the Target Scene

Choose the scene and entry point that should play after the interaction.
{% endstep %}

{% step %}

### Confirm the Timeline Path

Review the sequence that follows the target scene so the branch continues coherently.
{% endstep %}

{% step %}

### Preview Every Branch

Test each branch outcome, including the default path and any missing-data state.
{% endstep %}
{% endstepper %}

## Success Checks

Before publishing Branch Timeline, confirm:

* Every visible choice has a valid target scene.
* Each branch starts at the intended entry point.
* Returning or continuing from the branched scene follows the expected timeline.
* The default route works when no branch is selected.
* Platform flow and simulation checks still match the Studio routing.

{% content-ref url="/pages/vF3GOo8viXK19zuT75hD" %}
[Data in Studio](/apps/blings-studio/data.md)
{% endcontent-ref %}