> 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/trulyp/analytics/global-chart-options.md).

# Dashboard settings

The dashboard settings set the layout and look of the whole app: the grid, the theme and colours, fonts, the background, and the default behaviour of every chart. Individual visuals can override these defaults on their [Styling](/trulyp/analytics/visuals/configuring-a-visual.md#styling) sub-tab.

To open them, select the **Dashboard** tab in the editor, or choose **…** > **Dashboard settings**. Use **Search settings…** to find a setting quickly. Changes are visible immediately; click **Save** to keep them.

<div><figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fgit-blob-2bba699758651d04cb9ac243ffe6b18abdb172eb%2FAnalytics_Dashboard_Settings_Layout.png?alt=media" alt="Dashboard layout settings"><figcaption><p>Dashboard layout</p></figcaption></figure> <figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fgit-blob-4f52e1f1ed3d4c3ce986af65ff5769ccdaa8cdd3%2FAnalytics_Dashboard_Settings_Theme_palette.png?alt=media" alt="Theme and palette settings"><figcaption><p>Theme &#x26; palette</p></figcaption></figure> <figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fgit-blob-a1993c7ec4e22e621e72ef1a1b5638847710f7d6%2FAnalytics_Dashboard_Settings_Formatting_defaults.png?alt=media" alt="Formatting defaults"><figcaption><p>Formatting defaults</p></figcaption></figure></div>

### Dashboard layout

| Setting                                      | What it does                                                                                                     | Default    |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
| **Layout mode**                              | **Grid**: visuals never overlap. **Freeform**: visuals can overlap, for example on top of an image.              | Grid       |
| **Dashboard size**                           | **auto**: the canvas resizes with the screen. **fixed**: the canvas has a fixed size.                            | auto       |
| **Fixed width (px)** / **Fixed height (px)** | The size of a fixed canvas (only for fixed size).                                                                | 1200 × 800 |
| **Canvas overflow**                          | **auto**: scroll when content doesn't fit. **hidden**: cut it off.                                               | auto       |
| **Grid margin horizontal / vertical (px)**   | The space between visuals.                                                                                       | 6          |
| **Grid columns**                             | The number of columns in the grid: 12, 16, 24, 32, 48, 64 or 96. More columns give you finer control over sizes. | 48         |
| **Grid row height (px)**                     | The height of one grid row.                                                                                      | 27         |
| **Show gridlines (edit mode only)**          | Shows the grid while editing. Viewers never see it. You can also press **G**.                                    | off        |

### Theme & palette

| Setting                                           | What it does                                                                                                                                                  |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Base theme**                                    | The overall chart style: **Default**, **Sheets**, **Polychroma**, **Vivid** (the default) or **Material**, each also in a **Dark** variant.                   |
| **Use custom colors and typography**              | Switch on to override the colours and font size of the theme.                                                                                                 |
| **Palette fills (comma-separated)**               | Your own series colours, for example your brand colours: `#38bdf8,#a855f7,#f97316`. You can also click a swatch to change one colour. Requires custom colors. |
| **Font family**                                   | The font for chart text: Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, Nunito, Source Sans Pro, Work Sans or the system font.                          |
| **Base font size**                                | The default text size in charts. Requires custom colors.                                                                                                      |
| **Canvas background color**                       | The background behind the visuals.                                                                                                                            |
| **Canvas background image URL (overrides color)** | An image behind the visuals.                                                                                                                                  |
| **Corner radius (px)**                            | How rounded the tiles are.                                                                                                                                    |
| **Load Google Fonts**                             | Loads the chosen font from Google Fonts when it isn't installed on the viewer's device.                                                                       |

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fgit-blob-15a704a14221b92b9d42dcef7f5189ef7f218de5%2FAnalytics_Theme_Dark.png?alt=media" alt="The tutorial dashboard with a dark theme and dark canvas"><figcaption><p>The same app with the Polychroma Dark theme and a dark canvas background</p></figcaption></figure>

### Formatting defaults

| Setting                                                 | What it does                                                             | Default       |
| ------------------------------------------------------- | ------------------------------------------------------------------------ | ------------- |
| **Tooltips**                                            | Show values when hovering over a chart.                                  | on            |
| **Animations**                                          | Animate charts when data loads or changes.                               | on            |
| **Navigator**                                           | Show a navigator below time-series charts.                               | off           |
| **Zoom interactions**                                   | Let viewers zoom in on charts.                                           | off           |
| **Padding top / right / bottom / left**                 | The space between the chart and the edge of its tile.                    | 20            |
| **Tile background** and **Tile background opacity (%)** | The background of the tiles. Set the opacity to 0 for transparent tiles. | white, 100%   |
| **Tile border color** and **Tile border width (px)**    | The outline of the tiles.                                                | light grey, 1 |
| **Tile shadow enabled**                                 | A subtle shadow around the tiles.                                        | on            |

### Titles

* **Title (global override)**: one title for every chart. Leave it empty to let each visual use its own title.
* **Subtitle**: one subtitle for every chart.

{% hint style="success" %}
**Make an app match your brand in a minute:** switch on **Use custom colors and typography**, paste your brand colours into **Palette fills**, choose your font, and set a light **Canvas background color** with white tiles and a **Corner radius** of 12 to 16.
{% 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/trulyp/analytics/global-chart-options.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.
