> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/study-basics/question-types/tree-testing-questions.md).

# Tree testing questions

<table><thead><tr><th>Study type</th><th data-type="checkbox">Availability</th></tr></thead><tbody><tr><td><strong>Usability test</strong></td><td>true</td></tr><tr><td><strong>Media survey</strong></td><td>true</td></tr></tbody></table>

Tree testing questions let you discover how participants would work through a navigational structure to complete a desired objective or task. Let’s say you run an online clothing store and want to make sure certain articles of clothing can be found where your users expect them to be. Or maybe you’re developing a new music app and are unsure about the information architecture. With tree testing questions, you can find exactly what works for your users.

<img src="/files/d6b38b1b75a73d0259d37d1e01db9047c22c8dc9" alt="" width="375">

### Tree testing settings

When adding a tree testing question to your study, you’ll customize your question in the center of the builder:

<img src="/files/d82a877edfcf18dd36bff8a028eafe7f7a23bf5e" alt="" width="563">

Here’s a breakdown of each option:

| Setting                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prompt**                      | <p>The prompt or instructions participants see as part of this question. Here, a clear objective you want participants to complete using your provided tree structure. For example, “Show me how you would go about finding rain boots for the upcoming season.” Or “You’ve recently changed jobs and want to update your address. Where would you go to do that?”<br></p><p>You can format your text in the following ways:<br><br>- <em><code>bold</code></em> = <strong>bold</strong><br>- <em><code>italic</code></em> = <em>italic</em><br>- <code><[https://examplelink.com>](https://help.dscout.com/study-basics/question-types/https:/examplelink.com>)</code> = <a href="https://examplelink.com/"><https://examplelink.com></a><br>- <code>[Sample link](https://examplelink.com)</code> = <a href="https://examplelink.com/">Sample link</a></p> |
| **Add success path** (optional) | <p>The path you hope participants will take when completing the provided task. Including a success path lets you validate whether any structure you already have in place is working or whether it might need adjusting to meet users’ expectations. For more information, see <a href="#add-a-success-path-to-a-tree-testing-question">Add a success path to a tree testing question</a>.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> If you have more than one possible success path in mind, you can select up to two.</p></div>                                                                                                                                                                                                                                                 |
| **Tree**                        | The individual items that make up your navigational hierarchy. Here, you can add parent nodes as well as child nodes to create the structure you want participants to navigate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

### Add a tree testing question to a study

You’ll add tree testing questions on the **Usability test** or **Media survey** tab of your study.

{% stepper %}
{% step %}
Navigate to the **Usability test** or **Media survey** tab of your study.
{% endstep %}

{% step %}
Click **+ Add** in the center of the builder or in the left sidebar.

![](/files/d6c2d49c4ff2686c0fb3adc39221754a35ae58a3)
{% endstep %}

{% step %}
Under **Standard**, select **Tree testing**.

![](/files/f76a1affee91900e9b9682241898e7c74bd6dea5)
{% endstep %}

{% step %}
Enter the **Prompt** (instructions).

![](/files/0d6cb6d29ef0b21ac4f7a87558683f6db5182076)
{% endstep %}

{% step %}
Add nodes to build your **Tree**. Hover and click the **+** within a node to add child nodes. Your tree can have up to 300 nodes in total.

{% hint style="success" %}
**Tip:** Copy your tree structure from a spreadsheet and paste it into your question. For more information, see [Copy and paste a tree structure](#copy-and-paste-a-tree-structure).
{% endhint %}

![](/files/45bff1f879a1ca45870b11791417f7c2d3cc7755)
{% endstep %}

{% step %}
**(Optional)** Add a success path to your question. For more information, see [Add a success path to a tree testing question](#add-a-success-path-to-a-tree-testing-question).
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, your tree testing question is added to your study. When participants reach this question, they’ll see the provided instructions as well as a navigable version of your tree structure. They can move backward and forward within this structure before submitting their final response and moving on to the next question.

#### Copy and paste a tree structure

Instead of adding nodes to your tree manually, you can copy the structure from a spreadsheet and paste it into Dscout.

Spreadsheets must be in the following structure, with each node in its own cell and child nodes listed one column to the right of their parent node:

<img src="/files/9bd24e91e1182b741619ec0d7f6ca6689305250d" alt="" width="375">

Pasting this example into Dscout results in the following tree structure:

<img src="/files/716b6cca68c0534ca3a7600524462c5282869ec2" alt="" width="563">

#### Rearrange a tree structure

Once you've added your nodes, you can drag and drop them to rearrange your tree structure:

<img src="/files/2d53f69148becfa9a1c7d9927709f7976fae1ea4" alt="" width="375">

#### Add a success path to a tree testing question

If you have an ideal navigation path in mind, you can set that as a success path in Dscout to unlock additional insights during analysis. For example, with a set success path, you can view whether a participant took a direct route or an indirect route in their response.

{% stepper %}
{% step %}
After adding your tree structure, click **Add success path**. A success path modal is displayed with your entered tree structure.

![](/files/38e61165b1b1b5824e78068573ca9270992f1632)
{% endstep %}

{% step %}
Select the final node that indicates success if selected by the participant.

{% hint style="success" %}
**Tip:** If there are multiple possible success paths, you can **up to two nodes** in this modal. Your selected success paths are displayed to the left of the tree structure.
{% endhint %}

![](/files/8d7204d0db46868120c0fec8bc944e30d469ff0b)
{% endstep %}

{% step %}
Click **Save**.
{% endstep %}
{% endstepper %}

Now, your success path is set. You’ll be able to compare participant responses to this path during analysis.

### Edit a tree testing question

You can edit questions however you need prior to launching your study. However, if you want to edit a question after your study is launched, some changes will affect how your data appears in analysis. For example, removing a node from your tree entirely will split your data into two versions you'll need to analyze separately.

Here's a breakdown of which changes will and won't create a new version of your tree testing question's data:

| Won't cause versioning                                                                                                                                                                           | Will cause versioning                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| <ul><li>Editing a node's label.</li><li>Adding, updating, or removing a success path.</li><li>Rearranging node positions under the same parent (without moving nodes to a new parent).</li></ul> | <ul><li>Adding a new node.</li><li>Removing a node.</li><li>Moving a node to a different parent/level in the tree structure.</li></ul> |

For more information on editing your study post-launch, see [Edit a launched screener or study](/study-basics/edit-close-or-relaunch-missions/edit-a-launched-screener-or-study.md).

### Analyze a tree testing question

From the **Responses** tab of your study, you can see how all of your participants completed the given objective overall or narrow your view to individual participant responses.

#### Questions view

The **Questions** view gives you an overview of all responses to a given tree testing question, including metrics on the directness of participant selections, average time on task, and more.

![](/files/0504a254469fc6f19a57bed7a1201fd3ecfafc1f)

Here’s a breakdown of each metric:

| Metric                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Success rate** (questions with success path only)                  | <p>The percentage of participants who selected your designated success path.</p><p><br>If you have more than one possible success path, you’ll also see the percentage of participants who selected each individual path.</p>                                                                                                                                                                                                                                                                                                   |
| **Most common submission** (questions without success path only)     | The final node in your tree structure most commonly selected by participants.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Overall directness of success** (questions with success path only) | <p>The percentage of participants who selected your designated success path with no backward navigation in your tree structure.</p><p><br>If you have more than one possible success path, you’ll also see the percentage of participants who directly navigated to each individual path.</p>                                                                                                                                                                                                                                   |
| **Directness** (questions without success path only)                 | The percentage of participants who selected their path with no backward navigation in your tree structure.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Average time on task**                                             | <p>The average response time for the task across participants.</p><p><br>If your question has a success path, you’ll also see the average response time of all participants who submitted this success path as their final response.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If your question has multiple success paths, you’ll see an <strong>Overall average time on task</strong> as well as individual breakdowns for each success path.</p></div> |
| **Average clicks**                                                   | The average number of clicks made by participants before submitting their final responses.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Most common first click**                                          | <p>The node of your tree structure participants most often clicked first when completing the given task.</p><p><br>If your question has a success path, you’ll also see the node most commonly selected by participants who submitted this success path as their final response.</p>                                                                                                                                                                                                                                            |

You can also use the tabs below these metrics to open additional views. See the sections below for more information.

**Participant data**

Displays at-a-glance metrics for each participant’s response, including:

* **Success:** Whether the participant selected one of your designated success paths. This is only displayed if you selected a success path while building.
* **Time:** The amount of time the participant spent making their selection.
* **Clicks:** The number of clicks the participant took prior to submitting their selection.
* **First click:** The first node the participant selected while completing the task.
* **Submission:** The final node submitted by the participant.

![](/files/40d9fc978a0493535c3333a8cd21d58b80d7d6fb)

**Submitted nodes**

Displays a list of every selected node as well as the percentage of participants who selected it.

![](/files/f0115d61d59002321f240a117975358c778ab05f)

**Common paths**

Displays the most frequently selected paths as well as the percentage of participants that selected them.

**Start** in a path refers to the place participants begin the task, before making a selection. You'll see this in the path any time a participant navigated back to this starting point. ← indicates backward navigation.

![](/files/303979588193fea186aac0a67e2386eec1833603)

**Participant paths**

Displays the path selected by each individual participant.

**Start** in a path refers to the place participants begin the task, before making a selection. You'll see this in the path any time a participant navigated back to this starting point. ← indicates backward navigation.

![](/files/18fb35113a411dad9799304d680d6ccb4fba0f8b)

**First click**

Displays every node that was selected first by at least one participant as well as the total number of participants who selected the node first.

![](/files/c4a23606a2f3353351672195573ba445444f2114)

### Participants view

The **Participants** view gives you a closer look at individual participant responses to a tree testing question, including their submitted node, the path they took to get there, and more.

![](/files/f14433ec7bc29651fc9ffff0c0571e8ebb5da500)

Here’s a breakdown of each metric:

| Metric             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Submitted node** | <p>The final node selected by the participant. Above the node, you’ll see a colored indicator stating whether their path to this selection was direct or indirect.</p><p><br>If your question includes a success path, you’ll see one of the following:</p><ul><li><strong>Direct success:</strong> The participant selected the correct node and only moved forward through your tree structure.</li><li><strong>Indirect success:</strong> The participant selected the correct node but moved forward and backward in your tree structure.</li><li><strong>Direct fail:</strong> The participant did not select the correct node and only moved forward through your tree structure.</li><li><strong>Indirect fail:</strong> The participant did not select the correct node and moved forward and backward in your tree structure.</li></ul><p></p><p>If your question does not include a success path, you’ll see one of the following:</p><p></p><ul><li><strong>Direct:</strong> The participant only moved forward through your tree structure before making their final selection.</li><li><strong>Indirect:</strong> The participant moved forward and backward through your tree structure before making their final selection.</li></ul> |
| **Path**           | <p>The series of nodes the participant clicked to get to their final submission. Arrows between nodes indicate where the participant moved forward or backward in your tree structure.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> <strong>Start</strong> in a path refers to the place participants begin the task, before making a selection. You'll see this in the path any time a participant navigated back to this starting point. ← indicates backward navigation.</p></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Clicks**         | The number of clicks made by the participant before submitting their final response. Here, you’ll also find the average number of clicks across all participants in your study.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Time on task**   | The amount of time it took for the participant to submit their final response. Here, you’ll also find the average time on task across all participants in your study.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.dscout.com/study-basics/question-types/tree-testing-questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
