> 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/configuration/formatting/layout-configuration.md).

# Layout Configuration

Choose the buttons your viewers see, and show DrillDownTree as a popup.

Open the **Layout buttons** pane (icon tooltip "Layout and buttons") to choose which buttons your viewers get in the bottom-left corner of DrillDownTree. In the dashboard extension, this is also where you turn on popup mode.

<figure><img src="https://3696064508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffen81laUQFBf286HYARr%2Fuploads%2Fgit-blob-23fa22f473e4bdb2d2eaf227087ad1c00ab23a12%2FDDT_Layout_DashboardPane.png?alt=media" alt="The Layout buttons pane of the dashboard extension" width="490"><figcaption></figcaption></figure>

## Configure buttons

All buttons are turned on by default.

| Setting                    | Description                                                                                                                                                                                              |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enable sorting**         | Shows the **Alphabetic Sort** and **Numeric Sort** buttons, so viewers can change the sort order themselves.                                                                                             |
| **Enable print**           | Shows the **Print** button. When you turn this on, you can also set a **Document title**, which is printed as the heading of the page (default: "DrillDownTree"). Printing only works on Tableau Server. |
| **Enable legend button**   | Shows the **Legend** button, so viewers can show or hide the legend.                                                                                                                                     |
| **Enable reset button**    | Shows the **Reset** button, which takes the tree back to its top level.                                                                                                                                  |
| **Enable measure options** | Shows the measure switcher (the **Σ** button and the measure tabs or dropdown). Turn this off to show only one measure.                                                                                  |

See [Using DrillDownTree](https://docs.infotopics.com/drilldowntree/features/using-drilldowntree.md#viewer-buttons) for what each button does for your viewers.

## Configure popup

{% hint style="info" %}
Available only in the dashboard extension.
{% endhint %}

A DrillDownTree can take a lot of space on your dashboard. With popup mode, the extension only shows a button. The tree opens in a popup window when a viewer clicks that button, or when they select marks on one of the worksheets you choose. A perfect way to save valuable space!

1. Select **Show DrillDownTree in a popup on mark selection**.

   <figure><img src="https://3696064508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffen81laUQFBf286HYARr%2Fuploads%2Fgit-blob-596194e4eb3c7f673a2c04a015dd56ec522b0d51%2FDDT_Layout_ConfigurePopup.png?alt=media" alt="The Configure popup section" width="462"><figcaption></figcaption></figure>
2. In **Which worksheets should trigger the popup?**, select the worksheets that should open the popup when a viewer selects marks on them. You can select more than one.
3. Under **Configuration**, style the button so it fits your dashboard and corporate identity:

   | Setting                | Default            | Description                                                 |
   | ---------------------- | ------------------ | ----------------------------------------------------------- |
   | **Button Label**       | Open DrillDownTree | The text on the button.                                     |
   | **Text size**          | 12                 | The font size of the button text (5–18).                    |
   | **Size - Width(%)**    | 60                 | The width of the button, as a percentage of the extension.  |
   | **Size - Height(%)**   | 5                  | The height of the button, as a percentage of the extension. |
   | **Border radius (px)** | 0                  | The corner radius of the button (0–20).                     |
   | **Text color**         | Black              | The color of the button text.                               |
   | **Background color**   | White              | The color of the button.                                    |
   | **Canvas color**       | White              | The color of the area around the button.                    |
   | **Border color**       | Light grey         | The color of the button border.                             |
   | **Border width (px)**  | 1                  | The thickness of the button border (0–20).                  |
4. Click **Save**, then reload the extension.

{% hint style="warning" %}
Reload the extension every time you turn popup mode on or off.
{% endhint %}

{% hint style="warning" %}
You can't open **Customize measures** while popup mode is on. Turn popup mode off, reload the extension, customize your measures, and then turn popup mode back on.
{% endhint %}


---

# 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/configuration/formatting/layout-configuration.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.
