---
title: "Tree Chart"
slug: "tree-chart"
updated: 2023-03-10T18:47:37Z
published: 2023-03-10T18:47:37Z
canonical: "docs.preset.io/tree-chart"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.preset.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tree Chart

A **tree chart** excels at visualizing hierarchy. Here is an example of a tree chart created in Preset:

![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%204.04.43%20PM.png)

### Reference Content

The following articles may be useful resources as you build your chart:

- [Creating a Chart](/v1/docs/creating-a-chart): A walkthrough of the overall process of chart selection and creation.
- [Using Preset Chart Builder](/v1/docs/using-preset-explore): How to work with the Chart Builder page, the primary interface used when creating a chart.

## Creating a Tree Chart

Creating a tree chart is similar to creating a graph chart with one exception: tree charts enforce hierarchy while graph charts do not. You still need nodes (or circles) and edges (or connecting lines between circles), but you also need additional information on the hierarchy. Here's an example of how two edges and the connecting edge is rendered in Preset and the original data it originated from:

| ![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%204.15.20%20PM.png) | - The **name** column is to define the nodes we want created: - To create the *CEO* node, the **name** value in row 1 is set to *CEO* - To create the *VP of Marketing* node, the **name** value in row 2 is set to *VP of Marketing* - To create the edge connecting both nodes and define the hierarchy, the **id** and **parent** columns are used: - In row 1, the **id** is set to *root***,** which refers to the root node or the first node. This node always lives in the first layer of the tree. - In row 2, the **id** is set to **child1** and the **parent** is set to *root***.** This defines the parent of the *VP of Marketing* node to be the **root** node. |
| --- | --- |

Here's a diagram that showcases the full lifecycle of how the data flows from your database to Preset when generating a tree chart.

![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/tree_workflow.png)

If your data isn't shaped this way and you're unable to modify the data at your database level, we recommend re-shaping the data in SQL Lab and publishing the result as a virtual dataset.

## Customizing your Tree Chart

Under the **Customize** tab, you can find a number of options for customizing your tree chart further.

- **Tree Layout**: Orthogonal by default, but you can switch to a more circular (or Radial) layout if you'd like
- **Tree Orientation**: Choose between 2 horizontal tree options (*Left to Right, Right to Left)* and 2 vertical tree options (*Top to Bottom, Bottom to Top).*
- **Node Label Position:** Choose where you want the labels for the nodes to live in relation to the nodes themselves (*Left, Top, Bottom, Right*)
- **Child Label Position**: Choose where you want the labels for the children nodes to live (*Left, Top, Bottom, Right)*
- **Emphasis**: Define how you want the visual emphasis to be shown upon hovering (*Ancestor, Descendant*)
- **Symbol**: Define which symbol you want to be used to represent each node.
- **Symbol Size**: Slider to choose the size of each symbol (representing each node).
- **Enable Graph Roaming**: If you are visualizing a large number of nodes and edges and notice a slow down while scaling and moving, we recommend disabling some of the behaviors.
  - *Move only:* chart users can click and drag the chart view but not zoom in or out.
  - *Scale only*: chart users can zoom in or out but not click and drag the chart view.
  - *Scale and Move*: chart users can both zoom in or out or click and drag to move around the chart view.
  - *Disabled*: fixed chart view, no scaling or moving