# Model Tree
URL: https://docs.valsight.ai/model-tree/
Description: Show the model behind the numbers on a worksheet, as a graph of connected nodes carrying values per scenario.
A model tree draws the nodes of the underlying model as a graph on the worksheet, so you can show how a figure is arrived at rather than only what it is. In the chart type selection it is called **Tree**, under **Others**.

## What it is

Each node is drawn as a box: its name and unit in the header, then one row per period with the value. Connectors show which nodes feed which, so the chain from the drivers to the top figure is visible. Values can be shown for several scenarios at once.

![A model tree with gross profit broken down into revenue and cost nodes, each node listing values per year](./images/model-tree.png)

The tree is a view of the model, not a separate drawing. It follows the model's structure, so it changes when the model changes.

## When to use it

* You want to explain the cause and effect behind a number, not just present the number.
* You are walking an audience through a model for the first time.
* You want to show where an assumption enters the calculation.

Use a **[bridge](/bridges/)** instead when the question is why two values differ, and a **[waterfall](/bridges/)** when you want a build-up rather than the whole structure.

## Configuration

Most of what a model tree looks like comes from the nodes themselves, in the model editor, rather than from the chart:

| Setting                  | Where it lives         | What it does                                                                                                                                               |
| ------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Default Scale**        | Node advanced settings | Sets the scale a node's numbers are shown at, in every chart including the tree. See [Default Scale Settings in Nodes](/default-scale-settings-in-nodes/). |
| **Sort key**             | Node advanced settings | Sets the order the nodes appear in. See [Sort Key Settings in Nodes](/sort-key-settings-in-nodes/).                                                        |
| **Hide in workspace**    | Node advanced settings | Excludes a node from model tree charts. See [Advanced Node Settings](/advanced-node-settings/).                                                            |
| **Hide technical Nodes** | Workspace setting      | Overrides **hide in workspace** for the whole workspace.                                                                                                   |

## Good to know

* **A node hidden in the workspace will not appear.** Nodes marked **hide in workspace** are left out of model tree charts by default. Switch **Hide technical Nodes** off for the workspace to bring them back.
* **Hiding or coloring connectors does not carry over.** Those node settings affect the model editor, not the tree chart on a worksheet.
* **Unformatted large numbers are a node setting, not a chart setting.** A tree puts nodes of very different magnitudes side by side, and the chart's own scale applies to all of them at once, so raising it rounds the small values to zero. Set each node's **[Default Scale](/default-scale-settings-in-nodes/)** instead.
* **Node order is not alphabetical by default.** If costs sort above revenue, give the nodes sort keys.

## Related

* [Sort Key Settings in Nodes](/sort-key-settings-in-nodes/): controlling the order nodes appear in.
* [Default Scale Settings in Nodes](/default-scale-settings-in-nodes/): scaling a node's numbers, in the tree and in every other chart.
* [Advanced Node Settings](/advanced-node-settings/): the other node settings, including hide in workspace.
* [Chart Types](/chart-types/): the other chart types and tiles.