> For the complete documentation index, see [llms.txt](https://docs.infotopics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infotopics.com/drilldowntree/features/using-drilldowntree.md).

# Using DrillDownTree

Once your DrillDownTree is configured, you and your viewers can explore the data in any direction. This page explains everything you can do in the tree itself.

<figure><img src="https://3696064508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffen81laUQFBf286HYARr%2Fuploads%2Fgit-blob-4a46348c3653814da42820e6834ffd05fd6770ce%2FDDT_Using_Tree.png?alt=media" alt="A DrillDownTree drilled down from Category to Sub-Category"><figcaption></figcaption></figure>

## Drilling down

The tree starts with one node: the total of your measure. Click the **+** next to a node in the last level to open the **Explore** menu, which lists the dimensions you haven't used yet. Pick one to add it as the next level. Repeat this as often as you like, in any order you like.

The **+** is not shown when every dimension is already in the tree, or when the tree has reached the **Maximum depth** set in [General formatting and styling](https://docs.infotopics.com/drilldowntree/configuration/formatting/general-formatting-and-styling.md#nodes).

<figure><img src="https://3696064508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffen81laUQFBf286HYARr%2Fuploads%2Fgit-blob-6df9bdf152de6b4ff22f8b7dcf07ea8ef71ee061%2FDDT_Using_ExploreMenu.png?alt=media" alt="The Explore menu lists the dimensions you can drill into" width="340"><figcaption></figcaption></figure>

## Following a path

Click a node in an earlier level to make it the active node. The next level then shows the members of that node, so you can follow one path through your data. The header above each level shows the dimension and the member you selected.

## Removing a level

Drilled too far, or want to look at a different dimension? Click the header above a level to remove it from the tree. You can remove a level in the middle of your path too: the levels after it move up.

<figure><img src="https://appsfortableau.infotopics.com/wp-content/uploads/2021/07/Closing-Dimensions.gif" alt="Removing a level by clicking its header"><figcaption></figcaption></figure>

## Filtering and selecting

Click the active node again, or click a node in the last level, to filter. The nodes on the path stay highlighted and the rest fade out.

* In the dashboard extension, this filters the worksheets set in [Dashboard Actions](https://docs.infotopics.com/drilldowntree/configuration/formatting/dashboard-actions.md).
* In the viz extension, this selects the matching marks, so your Tableau worksheet actions are triggered.

Click the same node again, or click anywhere on the empty canvas, to clear the filter.

## Large dimensions and the "Other" node

When a dimension has more members than fit in a level, the remaining members are grouped in one node at the bottom, called "Other". You can rename it in [Label configuration](https://docs.infotopics.com/drilldowntree/configuration/formatting/label-configuration.md) and limit the number of nodes per level in [General formatting and styling](https://docs.infotopics.com/drilldowntree/configuration/formatting/general-formatting-and-styling.md#nodes). Use the **Explore** menu of the "Other" node to show its members.

<figure><img src="https://appsfortableau.infotopics.com/wp-content/uploads/2021/07/Other.gif" alt="Expanding the Other node"><figcaption></figcaption></figure>

## Tooltips

Hover over a node to see its full name, its percentage and the value of the active measure. Long labels are shortened in the tree, so the tooltip is the place to read them in full.

## Measure switching

When your DrillDownTree has more than one measure, viewers can switch between them at the bottom of the extension. Your drill path stays the same. Click **Σ** (Measure switch) to show or hide the measures. They appear as tabs or as a dropdown, depending on **Measure selector type** in [General formatting and styling](https://docs.infotopics.com/drilldowntree/configuration/formatting/general-formatting-and-styling.md#general).

You choose which measures are listed, their order and their names in [Customize measures](https://docs.infotopics.com/drilldowntree/configuration/customize-measures.md).

<figure><img src="https://3696064508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffen81laUQFBf286HYARr%2Fuploads%2Fgit-blob-44aa904bedc3f44f3b6634f4c5a5443868b05372%2FDDT-measure-switcher.png?alt=media" alt="The measure switcher at the bottom of DrillDownTree"><figcaption></figcaption></figure>

## Viewer buttons

The buttons in the bottom-left corner help your viewers along. You choose which ones are shown in [Layout configuration](https://docs.infotopics.com/drilldowntree/configuration/formatting/layout-configuration.md).

| Button              | What it does                                                                                                                                                                                                                                                                |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reset**           | Takes the tree back to its top level.                                                                                                                                                                                                                                       |
| **Alphabetic Sort** | Sorts the nodes by name. Click again to reverse the order.                                                                                                                                                                                                                  |
| **Numeric Sort**    | Sorts the nodes by value. Click again to reverse the order.                                                                                                                                                                                                                 |
| **Legend**          | Shows or hides the legend. Without conditional coloring, the legend shows the positive and negative colors. With [conditional coloring](https://docs.infotopics.com/drilldowntree/configuration/customize-measures/conditional-coloring.md), it shows your condition names. |
| **Print**           | Opens a print-friendly version of the tree (Tableau Server only).                                                                                                                                                                                                           |

## Scrolling

When your tree gets wider than the extension, a horizontal scroll bar appears, so you can drill down as deep as you want.

<figure><img src="https://appsfortableau.infotopics.com/wp-content/uploads/2021/07/Horizontal-Scroller.gif" alt="Scrolling horizontally through a wide tree"><figcaption></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://docs.infotopics.com/drilldowntree/features/using-drilldowntree.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.
