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

# Dashboards

> Build a dashboard of widgets over your own records, share it, filter it, and read the Company Overview that shows how the company's work stands.

A dashboard is a screen of widgets that answer questions about your work: how many Actions are overdue, which Projects are behind, what changed this week. Every widget reads live records, so a dashboard is never out of date. Your [Home](https://docs.saphion.co.uk/work/home.md), each Project's Overview and the Company Overview are all dashboards. You can make as many of your own as you like.

> [!NOTE]
>
> Everyone with a Platform seat can make dashboards and see their own.

![A dashboard with figures, a Project portfolio and an Actions chart.](https://mintcdn.com/saphion/F5a0XE-YKidXHEWP/images/work/dashboards-1.webp?fit=max\&auto=format\&n=F5a0XE-YKidXHEWP\&q=85\&s=2cbd7eb192ba6e7c80bd01034fb5b507)

A dashboard

## Make a dashboard

**1. Start it**

Choose **Creations**, then **New > Dashboard**. A Project's **Creations** tab offers the same choice and files the dashboard in that Project. A new dashboard opens straight away and is private to you.

**2. Say what you want to see, or build it yourself**

An empty dashboard asks "What would you like to see?" with the example "show overdue actions by project and completed work this month". Describe it and Beacon builds the widgets, which you can then adjust. Or choose **Add widget** and build it by hand. See [Build a dashboard with Beacon](#build-a-dashboard-with-beacon).

**3. Add widgets**

In **Add widget**, pick a ready-made widget or a custom one. See below.

**4. Save**

Choose **Save changes**. Nothing is kept until you do, and **Cancel** drops the draft.

## Build a dashboard with Beacon

Ask Beacon for the dashboard you want, in a chat or from an empty dashboard. Beacon starts a blank dashboard, then adds its widgets one at a time. It checks each widget as it saves it, and tells you what each one shows. If a widget does not fit its data, for example a field that cannot be counted, Saphion refuses it and names the widget, the setting and the fix, so Beacon can put it right.

When Beacon makes a dashboard in a chat, the dashboard opens beside the chat straight away and shows that it is being made. It fills in as each widget is added. A dashboard Beacon made is yours like any other: it is private to you, or filed in the Project you asked for, and you can edit, share or delete it.

You can also ask Beacon to change one widget, move it or remove it, without touching the rest. Claude, ChatGPT and other connected tools build and change dashboards in the same way. See [Saphion in other AI tools](https://docs.saphion.co.uk/beacon/other-ai-tools.md).

A dashboard has its own screen, with its name as the heading and a star beside it. If you have several, **Creations** lists them all. See [Favourites and Creations](https://docs.saphion.co.uk/work/favourites-and-creations.md).

## Widgets

Choose **Add widget**, or **Customise > Edit layout** on an existing dashboard and then **Add widget**. The dialog says "Choose a ready-made widget, or build your own."

### Ready-made widgets

Ready-made widgets are grouped on the left by what they read, and each card shows a preview. Choose a size if the widget offers more than one, then choose **Add** and the widget's name. Search with **Search widgets**.

| Group | What it offers |
| - | - |
| **Actions** | **My Actions**, **No date yet**, **Waiting on others** and **Completed Actions**. They run from a single count up to the full list grouped by when they fall due. Each can be limited to one Project. |
| **Waiting on you** | Everything waiting on you: reviews, requests, decisions and overdue work. |
| **Calendar** | **Today's calendar**, from Saphion and your connected calendars. |
| **Projects** | **My projects**, with client, status and lead. |
| **Activity** | **Recent activity**, across the workspace or in one Project. |
| **CRM** | Widgets over your pipeline, if your Organisation holds CRM. |

### Custom widgets

Choose **Custom widget** to build your own. Pick a kind, then **Configure** it: choose the data, how it is measured and how it is shown.

| Kind | What it is for |
| - | - |
| **Metric** | One card of one to six numbers, each with an optional comparison, icon, detail line and small trend, breakdown or target. |
| **Chart** | Compare, trend or break down measures as bars, lines and more. |
| **Compare** | Two sources joined on a date and shown together, marking rows held by only one. |
| **Progress** | Progress towards a target you set. |
| **List** | Named records with their status and the details that need attention, or a ranked top list. |
| **Details** | One record's named facts, editable where the record allows. |
| **Table** | A real table of one source's records, where you change fields and open records as you may on the board. |
| **Timeline** | Records as bars on a date scale. |
| **Calendar** | Work on its days by month, and your own time by week or day. |
| **Kanban** | Records as cards in lanes. Move a card to change its state where you may. |
| **Map** | A source's records as pins at their addresses. |
| **Visualization** | A saved interactive visualization, shown at its exact version. |

A kind that has no compatible data yet is greyed and says "No compatible source is currently available."

### Arrange and change widgets

In edit mode each widget can be dragged to a new place. Its menu offers **Configure**, **Width**, **Size**, **Settings**, **Duplicate**, **Columns** where it is a table, **Download image** and **Delete widget**. Width is one of quarter, third, half, two thirds or full, and a kind offers only the widths it reads well at. Height follows the content. Deleting a widget asks you to confirm.

![A dashboard in edit mode with the widget controls and drag handles.](https://mintcdn.com/saphion/F5a0XE-YKidXHEWP/images/work/dashboards-2.webp?fit=max\&auto=format\&n=F5a0XE-YKidXHEWP\&q=85\&s=4a7c7d6cbc61d974d8272e79301a3897)

Editing a dashboard

If someone else saves the dashboard while you are editing, Saphion tells you "changed while you were editing" and keeps your draft. You choose whether to keep your draft or use the latest version.

## Filter a dashboard

Choose **Filter** in the header. The dashboard can be narrowed by a Project, a person or a product, whichever its data offers, and every widget follows at once. The conditions appear as chips under the heading, and **Clear all** removes them.

A shared dashboard is looked at together, so it has two kinds of filter.

* **The dashboard's own filter.** An Editor sets it in edit mode, with **Filter** in the header, and it is saved with the dashboard. Everyone who opens the dashboard starts from it, so a meeting looks at the same picture.
* **Your own view.** Outside edit mode, your filter, period, product and chart looks are yours, and Saphion keeps them for next time. Nobody else sees them, and they never change the saved dashboard.

While your view differs from the dashboard's, a quiet **Your view** line shows under the heading. Choose **Reset to dashboard** to go back to the dashboard's picture. Clearing your filter also goes back to the dashboard's own. If your filter names a Project, Team or person that has gone or is no longer open to you, the dashboard says that part no longer applies.

## Share a dashboard

The faces in the header open the **Share** dialog. A dashboard you made has an Owner and two levels for everyone else: **Editor** and **Viewer**. The Owner can **Transfer ownership**, and an Admin can open a dashboard to the whole Organisation, as view only. Someone who cannot open a dashboard can ask for access. See [Sharing and access](https://docs.saphion.co.uk/work/sharing-and-access.md).

Sharing a dashboard never gives anyone more records than they already have. Every widget reads as the person looking at it, so a colleague sees only the records they are allowed to open.

## Rename, archive and delete

The **⋯** menu (**Dashboard actions**) has **Rename**, **Archive** and **Delete**. Archive hides the dashboard and you can restore it from **Archive**. Delete moves it to the Bin for 30 days. Archiving and deleting are for the dashboard's Owner and Admins. See [Bin and restore](https://docs.saphion.co.uk/admin/bin-and-restore.md). A dashboard Saphion makes for a place, such as Home, a Project's Overview or the Company Overview, cannot be renamed or deleted.

## Company Overview

The Company Overview is a dashboard for Organisation Admins that shows how the company's work stands. Choose **Company Overview** at the top of the Workspace group in the sidebar.

| Widget | What it shows |
| - | - |
| Figures | **Active projects** (with how many are due in the next 30 days), **Open actions** (with how many are due in the next 7 days), **Overdue** and **Completed**. |
| **Project portfolio** | Active Projects with lead, status, progress, next milestone and overdue Actions. |
| **Actions by status** | A bar chart of every Action by its status. |
| **Upcoming milestones** | Milestones due in the next 30 days, or overdue, where your Organisation holds programmes. |
| **Recent activity** | The latest changes across the workspace. |

Every figure and row opens the work behind it. **New project** is the primary button. **Customise** works as on any dashboard, and a card on it opens its record where you are.

## How it works

* **The Company Overview is for Organisation Admins.** A dashboard shows each viewer only what that viewer is allowed to see.
* **Dashboards read live.** There are no snapshots to refresh. When someone changes a record, the figures move without a reload.
* **One question, one answer.** A figure and the list it opens use the same definition, so they always agree.
* **Deleting a field reaches its widgets.** Columns, card fields and colours that showed the field are removed with it and come back with **Undo**. A widget whose figure was built on the field says which field was removed.
* **Shares read as shares.** A chart stacked to 100% has an axis from 0 to 100%.
* **Ready-made widgets stay adjustable.** A ready-made widget keeps its chosen size and settings, so you can resize it or change them later.
* **Reset layout.** It appears only on a dashboard Saphion composes for you, such as Home. **Reset layout** in the edit bar puts the widgets back in the default layout and keeps your own.

## Ask Beacon

* "Make me a dashboard of overdue Actions by Project and what we completed this month."
* "Add a chart of Actions by status to this dashboard."
* "Make the Overdue chart half width and move it to the top."

See [Chat with Beacon](https://docs.saphion.co.uk/beacon/chat.md).

## FAQ

> **Why can I not see the Company Overview?**
>
> It is offered to Organisation Admins. Ask an Admin if you need the picture it gives.

> **Why does a colleague see fewer numbers than I do?**
>
> Every widget reads as the viewer. They may not have access to some of the Projects or records.

> **Why is a widget greyed or missing from Add widget?**
>
> A ready-made widget is offered only if your Organisation holds the product it reads, and a custom kind needs a compatible source of data.

> **Can I put a dashboard on a board?**
>
> Yes. Choose **Dashboard** from a board's **+** view menu to add a saved dashboard as one of its views. See [Boards, tables and views](https://docs.saphion.co.uk/work/boards-and-views.md).

## Related

* [Home](https://docs.saphion.co.uk/work/home.md): Your own dashboard.
* [Projects](https://docs.saphion.co.uk/work/projects.md): A Project's Overview is its own dashboard.
* [Favourites and Creations](https://docs.saphion.co.uk/work/favourites-and-creations.md): Find every dashboard you made.
* [Sharing and access](https://docs.saphion.co.uk/work/sharing-and-access.md): Decide who can open and edit a dashboard.


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