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

# Build a dashboard

> Create a dashboard, add charts and text to it, arrange them, and set its time range and page filters.

Build a [dashboard](https://www.plain.com/docs/product/platform/dashboards.md) from metrics in the chart catalog and text tiles, then set the time range and page filters everyone sees. You need the Owner, Admin, or Support role. Viewers can open dashboards but not change them.

## Create a dashboard

A new dashboard starts empty and shows the past month.

**1. Open the dashboards list**

Go to [**Insights → Dashboards**](https://app.plain.com/~/insights/dashboards).

**2. Name the dashboard**

Click **New dashboard**, enter a name, and click **Create**. The new dashboard opens.

## Add charts and text

Add tiles in edit mode, then save them all at once.

**1. Start editing**

Click **Edit** at the top of the dashboard. On an empty dashboard, click **Add to dashboard**. The **Add to dashboard** panel opens.

**2. Add a chart**

Click a metric in the panel to add it at the end, or drag it onto an empty cell. Search by name with **Search metrics…**. Badges under the name show the chart types it supports, and the new tile uses the default type. You can add the same metric more than once, for example to show it with 2 different filters. Change the type later in the [chart's options](https://www.plain.com/docs/product/platform/dashboards/configure-charts.md#choose-a-chart-type).

**3. Add text**

Click **Text** at the top of the panel, then write in the tile in Markdown. A text tile holds up to 5,000 characters. Links work, but images don't display.

**4. Save**

Click **Save**. Click **Cancel** to discard your changes instead.

Each new tile goes in the next free column after the last tile. A dashboard holds up to 50 tiles. While you edit, you can also rename a chart by clicking its title, and [configure the chart](https://www.plain.com/docs/product/platform/dashboards/configure-charts.md).

If you leave the page or click **Cancel** with unsaved changes, Plain asks you to confirm before it discards them.

## Arrange tiles

In edit mode, drag a tile by any part of it onto another cell of the grid. Dropping it on a tile that is already there swaps the two. Edit mode adds an empty row below the last tile, so you can drag a tile onto a new row. To remove a tile, click the **×** in its corner. Click **Save** to keep the new layout.

## Set the dashboard's time range

Pick a range from the time range menu at the top of the dashboard. Choose a preset, from **Past 24 hours** to **Past year**, or **Custom** to pick start and end dates.

Outside edit mode, the range changes only what you see. Refreshing the page, or clicking **Edit**, brings back the saved range.

To change the range for everyone, click **Edit**, pick the range, and click **Save**. A chart with its [own time frame](https://www.plain.com/docs/product/platform/dashboards/configure-charts.md#give-a-chart-its-own-time-frame) keeps that time frame.

## Filter every chart

**Page filters**, next to the time range, narrow every chart on the dashboard to the same threads. They use the same dimensions as [Insights filters](https://www.plain.com/docs/product/platform/insights-filters.md). A chart's own filters still apply: Plain combines them with the page filters using **AND**. Clearing the page filters leaves each chart's filters in place. **Customers helped** ignores the time range, and page filters still apply to it.

Outside edit mode, page filters change only what you see. Refreshing the page, or clicking **Edit**, brings back the saved filters.

To change them for everyone, click **Edit**, set the filters, and click **Save**. Duplicating a dashboard copies its saved page filters.

**1. Add a filter group**

Click **Page filters** and pick a dimension and value. Each filter you add from **Page filters** starts its own group, shown under the header.

**2. Add to a group**

Click **+** on a group to add another filter to that group.

**3. Clear them**

Click **Clear** to remove every page filter.

Groups on the page combine with **AND** only. The control explains that limit. To use **OR**, add the condition in a [chart's own filters](https://www.plain.com/docs/product/platform/dashboards/configure-charts.md#filter-a-chart).

If the saved filters can't be edited in these controls, the header reads **Some saved page filters can't be edited here.** The charts keep using those filters until you click **Clear**. If Plain can't read the filters at all, it shows **Couldn't read page filters** and hides the charts until you clear them.

## Rename, duplicate, or delete a dashboard

Manage a dashboard from the **…** menu next to it in the dashboards list, or at the top of the dashboard:

* **Rename**: in the list, choose **Rename** from the **…** menu. On the dashboard, click **Edit**, change the name at the top, and click **Save**
* **Duplicate**: copies the dashboard's charts, text, time range, and page filters into a new dashboard named after the original with **(copy)** added. The copy opens once it's created
* **Delete**: deletes the dashboard and its charts for everyone in your workspace

> [!WARNING]
>
> Deleting a dashboard can't be undone. Any Owner, Admin, or Support user can delete any dashboard, not only the user who created it.

## Pin a dashboard to the sidebar

Click the star next to a dashboard's name to [favorite](https://www.plain.com/docs/product/platform/views/favorites.md) it. A favorited dashboard appears in 2 places: under **Dashboards** in the Insights sidebar, and in the **Favorites** section of the main thread list sidebar. Favorites are personal, so pinning a dashboard doesn't change anyone else's sidebar.

## Share a dashboard

Copy the dashboard's URL from your browser and send it to anyone in your workspace. Every dashboard is visible to everyone in the workspace, so the link opens the same charts for them.


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