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

# Dashboards

Build a dashboard of live numbers, charts, lists and content, filter it by clicking a chart, drill into the records behind any number, and make it your landing page.

A dashboard puts the numbers and lists you watch on one page: counts, totals, scores, charts, measures, your own tasks and any content you have saved. Every widget reads live data each time the dashboard opens, so it never goes stale.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-f52f14dda56b1b9dd5d45aa7ee1c38f54431215f%2Fcommand-dashboard-overview.png?alt=media" alt="A dashboard with a KPI number, two donut charts and a record list, filtered by the Medium slice of the business criticality donut, with the selection shown in the filter bar."><figcaption><p>A dashboard with a linked filter</p></figcaption></figure>

## What it is

A dashboard is a grid of *widgets*. Each widget shows one thing and keeps only its settings; its data is read again every time.

| Group                  | Widgets                                                                                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Numbers & scores**   | **KPI number** (a count, total, average, lowest or highest value), **Record score**, **Portfolio score**, **Data quality**                                 |
| **Charts & lifecycle** | **Bar chart**, **Donut chart**, **Lifecycle phases**                                                                                                       |
| **Measures & trends**  | **Measure gauge** (latest value against a target), **Measure trend** (actual and planned by quarter), **Record measures**                                  |
| **Record lists**       | **Record list**                                                                                                                                            |
| **Content & links**    | **Saved content** (anything in My Space), **Models board**, **Text & notes**, **Image**, **Link button**, **Shortcut tile**, **Web page**, **Custom HTML** |
| **My work**            | **My tasks**, **My records**, **Ask Command**, **Recent work**, **Notifications**, each showing the viewer's own                                           |

## When to use it

* You report the same figures every week and want them in one place.
* You want a page that answers one question for one audience, such as a CFO view of cost.
* You want your own start page in Command: see [Make it your landing page](#make-it-your-landing-page).

## How to

### Create a dashboard

1. Click **Create** (**+**) and choose **Dashboard**. A new dashboard opens ready to edit.
2. Click **Choose a dashboard template** to start from a ready-made view, such as **Executive Dashboard** or **CFO Dashboard**, filled from data you can access. Or click **Add your first widget** to build it yourself.

### Add widgets

1. Click **Edit** in the header if the dashboard is not in edit mode yet.
2. Click **Add widget**. The **Add a widget** panel opens.
3. Find a widget by group or with **Search widgets…**, and click it. It lands in the first free space.
4. Click **Configure** on the widget, choose its source and options, and click **Save widget**.

You can also drag in content and records: something from **My Space** becomes a **Saved content** widget, and records from the [Data Hub](https://docs.ins-pi.com/command/the-portal/data-hub.md) become **Record measures** widgets.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-281470c719bd3cddb92b579cf68a56f67e370aa3%2Fcommand-dashboard-add-widget.png?alt=media" alt="The Add a widget panel beside a dashboard in edit mode, listing the Numbers and scores widgets."><figcaption><p>The widget catalog</p></figcaption></figure>

### Arrange widgets

* **With a pointer:** drag a widget by its header to move it, and drag its corner to resize it. Widgets in the way move down.
* **With the keyboard:** select a widget, then use the arrow keys to move it, **Shift** + arrow keys to resize it, **Enter** to configure it and **Delete** to remove it.
* **By numbers:** in **Configure**, set the column, row, width and height under **Position & size**.
* **On a phone:** widgets stack in one column. Use **Move up** and **Move down** to reorder them, and drag the handle to change the height.

Removing a widget takes one click. Click **Undo** in the message that appears to put it back with its settings. **⋮ > Clear** removes every widget, and asks first.

Changes are kept as you make them; there is no Save button.

### Filter by clicking a chart

1. In edit mode, configure a **Bar chart** or **Donut chart** and check **Use chart selections as dashboard filters**.
2. On each **KPI number**, **Record list** or chart that should respond, check **Follow dashboard filters**. If it reads another table, choose under **Filter from …** which field links the two.
3. Leave edit mode and click a bar or slice. The widgets that follow update; the rest stay as they are.

The filter bar shows each selection, with **Open records** to see the matching records and **Clear all filters** to start again. Selections are not saved: they clear when you leave or edit the dashboard.

To give viewers a filter of their own, add one under **Shared filters** in edit mode: **Add category filter** for a field's values, or **Add date range** for periods such as **Last 30 days**.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-2c053d7ac9dbf88ca4ea06e043700f79de4ea3b0%2Fcommand-dashboard-linked-filter.gif?alt=media" alt="A donut slice is clicked, the linked KPI numbers and record list update, and the filter is cleared again."><figcaption><p>Filter a dashboard by clicking a chart</p></figcaption></figure>

### See the records behind a number

Click a **KPI number**, a bar or a donut slice. The records it counts open in a new tab as a list.

### Make it your landing page

1. Save the dashboard in **My Space** first.
2. Open **⋮** and choose **Make landing page**.
3. Confirm with **Make landing page**. This dashboard is now what you see when you open Command; your previous landing page stays in My Space.

See [Home and landing pages](https://docs.ins-pi.com/command/the-portal/home.md).

### Share and download

Click **Share** to copy a link, or to copy or download the dashboard as an image (**PNG**, **JPG**) or a **PDF**.

## Good to know

* You need editor rights on the dashboard to change it. Without them, **Edit** is unavailable.
* A **KPI number** shows **No values** when no record has a value, and says how many records it covers when only some do, such as *on 128 of 140 records*.
* Percentages never round a group with records down to 0%: a small group shows *<1%*.
* A widget that adds up a large source shows its progress while it reads, and says when a total is estimated from part of the records.
* A dashboard built from a [guided analysis](https://docs.ins-pi.com/command/features/guided-use-cases.md) opens with **Key figures from this run**: the figures exactly as the run computed them, which never change. The widgets below read the records live, so they can differ.
* **Record score** and **Portfolio score** tiles show a score with the decimals set on it in [Scoring](https://docs.ins-pi.com/command/features/scoring.md).
* **Web page** shows only sites that allow being embedded.
* Only a Command administrator can add or change a **Custom HTML** widget. Others can still move and resize it.
* Uploading an image or an icon needs the dashboard saved in My Space first.

## Related

* [Content Types](https://docs.ins-pi.com/command/the-portal/content-types.md)
* [Measures](https://docs.ins-pi.com/command/features/measures.md)
* [My Space and Sharing](https://docs.ins-pi.com/command/the-portal/my-space.md)


---

# 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.ins-pi.com/command/features/dashboards.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.
