> For the complete documentation index, see [llms.txt](https://helpdocs.conducttr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocs.conducttr.com/colibri/building-exercises/branching-and-choices.md).

# Branching and Choices

In exercises, you can create branching based on player choices. Designing exercises that consider **player agency** ensures they are immersive. Training is much more memorable and effective when players **experience the impact of their choices**.

<details>

<summary>What is branching?</summary>

Branching is when a scenario **splits into different paths** based on a decision point.&#x20;

</details>

<img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FdroO4y4jBwaV5OjP0jHh%2Ffile.excalidraw.svg?alt=media&amp;token=3a2152e6-ae80-497c-af05-3bcbabb8f751" alt="How branching works" class="gitbook-drawing">

## How to

Follow these three steps to set up branching in your scenario table:

{% stepper %}
{% step %}

#### Create a new step as a question type

To branch, select either `Choice` or `Drop-down list` under *Type of question*.

{% hint style="danger" %}
You won't be able to branch with either Multiselect or Open text options. This is because there is no clear answer.&#x20;
{% endhint %}

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FXUGbGFHMdh3CNIAeZqJP%2Fquestion%20choice.png?alt=media&amp;token=e1323518-e8ce-4143-ba78-02830dce80d4" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

#### Select the persona and channel

Fill out the content of the step (which should include a question).

{% hint style="success" %}
Click the :sparkles: icon to generate content with our AI Assistant.
{% endhint %}

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FH8nXqieYJslWacqrLHUE%2Fquestion%20body.png?alt=media&amp;token=b4299c3f-9af5-4de6-ad09-23e5c0b6265d" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Go into the `Interactions` tab

Click `+ Add new option` to create a response to the persona question. Fill out the button text and decide which step will be activated as a result of the player selecting it. To achieve branching, the **activated steps for each button should be different**.

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FiHhswvOLTHV2MZ3IrzCX%2Fbranching.png?alt=media&amp;token=b2c471bb-0678-4ef5-8e43-e54dc651fb9d" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Arrange

You can branch with Arrange but it's important to note the answer arranged at the top is the one that activates the next step (the outcome):

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FYqgcsU2q3KVCoIi52fn7%2Farrange%20branching.png?alt=media&amp;token=eefe499b-c160-4e84-9ad7-20dd7e9778fb" alt=""><figcaption></figcaption></figure>

## When to use

Use branching in your exercise when you want players to experience the impact of their choices. This is most effective when the right answer isn't entirely clear. As a result, different players will have different experiences within the same exercise based on their own perspectives.

### Alternate endings

A great way to use branching is to create alternate endings for players based on their actions. It may be that you don't need to use branching throughout your exercise but only at the end for maximum impact.

This would work for scenarios where **tension culminates into one dilemma**. By using alternate endings, players can feel and experience the consequences of their actions.

<img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FOhfGuNcgaImd7LrvqIjZ%2Ffile.excalidraw.svg?alt=media&amp;token=da9d49f6-8dcf-4898-92de-7567baf63a0f" alt="" class="gitbook-drawing">

### :zap:Avoid overuse

Too much branching can **overcomplicate exercises**. Only use when necessary to immerse players and get the most out of experiential learning. If you're using branching in the middle of an exercise, it's recommended to **eventually bring the scenario back into one pathway again unless you're using alternate endings.**

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FPI7LRB4EGh5weU27NF8O%2Fbranching1.png?alt=media&amp;token=faa54ead-74c9-4ed6-8781-732bfb5ecdd8" alt=""><figcaption><p>Our recommended approach to branching</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdocs.conducttr.com/colibri/building-exercises/branching-and-choices.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
