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

# Dashboards

> Build dashboards from KPI, chart, map, table, ranking and text blocks, then publish them to your customers' portal.

Select **Reports** in the **Insights** group of the sidebar, then the **Dashboards** tab (`/dashboards`).

Dashboards let you build views of spend and usage and publish them to the white-label portal for the accounts they are for. Custom measures add your own formulas for any dashboard to use.

> [!NOTE]
>
> The **Dashboards** and **Custom measures** tabs only appear when your role includes the dashboards permission. Creating, duplicating and deleting dashboards each need the matching permission.

## The dashboards list

The grid shows each dashboard's **Name**, **Status**, **Audience** (how many accounts it is published to), **Template**, and **Updated** date. Row actions let you **Duplicate** a dashboard (the copy starts as a draft) or **Delete** it. Deleting a dashboard removes it for portal users too.

**Status** is one of:

* **Draft**: not yet published
* **Published**: live in the portal
* **Draft differs from published**: published, with unpublished edits

## Creating a dashboard

**1. Start a new dashboard**

Click **New dashboard** and enter a **Name**.

**2. Choose a starting layout**

Leave **Start with a standard layout** ticked to begin with a set of spend blocks, or untick it to start empty.

**3. Add blocks**

Click a block button above the canvas (see [Block types](#block-types)). Drag a block to move it, or use the arrow keys (Shift+arrows to resize). Click **Edit block** to set its **Title**, measures, comparison, filters and other options.

**4. Set the audience**

Click **Settings** and choose the **Audience**. Portal users of these accounts, and of every account beneath them, see the dashboard once published.

**5. Publish**

Click **Publish**. After later edits, click **Publish changes** to update what customers see.

Changes save automatically while you edit.

## Block types

| Block | Use it for |
| - | - |
| **KPI** | One headline figure, optionally compared with an earlier period |
| **Line chart** | Up to four measures along an x axis |
| **Area chart** | Up to four measures along an x axis, filled |
| **Bar chart** | Up to four measures along an x axis, vertical or horizontal |
| **Pie chart** | One measure split by a dimension |
| **Treemap** | One measure split by a dimension, sized by value |
| **Funnel** | One measure split by a dimension, drawn as a funnel |
| **Site map** | One measure by site, on a map |
| **Table** | Up to four measures, one row per dimension value |
| **Ranking** | One measure ranked across a dimension |
| **Text** | Headings and notes, written in Markdown |

## Dashboard settings

Click **Settings** to open the settings drawer:

* **Name** and **Description**
* **Audience**: the accounts the dashboard is published to
* **Template (a starting point to duplicate for other accounts)**
* **Dashboard filters**: filters applied to every block
* **Filters viewers can change**: which of **Period**, **Account**, **Agreement**, **State**, **Site**, **Utility** and **Site tag** portal users can adjust

## Previewing and unpublishing

Click **View as customer** to see the published dashboard as a portal user does. Click **Unpublish** to take it out of the portal; portal users stop seeing it straight away.

## Custom measures

The **Custom measures** tab (`/dashboards/measures`) holds formulas over spend, consumption, demand, emissions and [site data](https://docs.utilified.com/site-data.md) that any dashboard can use.

Click **New measure** and fill in:

* **Name** and **Key**
* **Formula**
* **Format**: **Number**, **Decimal**, **Currency**, or **Percent (0.25 shows as 25%)**
* **Decimals** and **Unit label** (for example, `$/kWh`)

The grid lists each measure's **Name**, **Key**, **Formula**, **Format** and **Unit**.

## Related guides

* [Reports](https://docs.utilified.com/reports.md)
* [Site data](https://docs.utilified.com/site-data.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.