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

# Dashboards

> Lay out results as a dashboard of cards and value boxes, track pipeline runs, and share the result.

Build a dashboard to present results at a glance, as cards, value boxes, and charts arranged in rows and columns. A **dashboard** is a Markdown (`.md`) file written in Quarto dashboard syntax. The saved file holds the layout, text, and values, so it stays readable outside Qualia. For long-form prose, use a [writeup](https://docs.quadrillion.ai/writeups.md) instead.

## Create a dashboard

Ask the agent to create one. For example, try "Make a dashboard of this week's experiment results." To write one yourself, create a `.md` file and add `format: dashboard` to its YAML frontmatter:

```markdown theme={null}
---
title: Weekly overview
format: dashboard
---

# Overview

## Row

::: {.valuebox}
Completed experiments

42

Up from 38 last week.
:::

::: {.card title="Findings"}

The new protocol improved throughput.

:::
```

## Lay out pages, rows, and columns

You set the layout with headings. The frontmatter `title` names a standalone dashboard.

* `#` headings create pages, such as `# Overview`.
* `##` headings create rows, such as `## Row`.
* `###` headings divide a row into columns. Deeper headings keep alternating between rows and columns.

To give a column a relative width, add `{width=60%}` to its heading. To start with columns instead of rows, use `format: {dashboard: {orientation: columns}}`. To show a row's or column's cards as tabs, add `{.tabset}` to its heading; each tab takes its name from a card's `title` attribute.

## Fill cards

You can put Markdown text, tables, images, and captured Plotly charts in a card.

* **Embed a figure**: Put `[[figure:C-123]]` in its own paragraph inside a card. `C-123` is the ID of a captured figure in [Knowledge](https://docs.quadrillion.ai/knowledge.md).
* **Cite evidence**: Add `[[claim:C-123]]` after a statement. A **claim** is a recorded finding or piece of evidence, such as a value captured from a notebook.
* **Add images**: Keep them in a folder beside the dashboard named `[FILENAME].assets/`, such as `overview.assets/chart.png`.

### Value boxes

A `::: {.valuebox}` block shows its first paragraph as the label, its second as the value, and any remaining paragraphs as context. Write numbers, currency, percentages, and comparisons exactly as they should appear.

Qualia doesn't calculate dashboard values for you. Ask the agent to compute and verify them in a notebook or script, write them into the file, and cite the evidence. Values stay as saved until you or the agent update the file.

> [!NOTE]
>
> Qualia previews the saved Markdown and captured charts. It doesn't run Quarto code cells, inline calculations, or Shiny servers.

## Edit a dashboard

Click **Source** at the top right to edit the Markdown, then **Preview** to see the layout. Save source changes with **Cmd/Ctrl+S**. The preview updates whenever an agent saves changes.

## Follow pipeline runs

A **pipeline** is a saved set of instructions that produces a report or dashboard each time it runs, on demand or on a schedule. See [Pipelines](https://docs.quadrillion.ai/rules.md#pipelines) to create one.

Each run writes its report to `report.md` in its own run folder, so you keep every earlier run's results. To rename a pipeline's dashboard, rename the pipeline.

* **View a run**: Select it in the **Runs** sidebar to see its report and open its agent's chat, where you can ask about the results.
* **Start another run**: Click **New run**.

## Share a dashboard

In a cloud workspace, click **Share**, then **Copy** beside the link. Only the project owner can choose who may open it:

* **Project viewers** (default): People with view access to the project, after signing in.
* **Anyone with the link**: Anyone, without signing in.

The access setting covers the whole dashboard and all its runs. Switch back to **Project viewers** to turn off anonymous access. A shared link doesn't give access to the rest of the project; to manage project membership, see [Shared workspaces](https://docs.quadrillion.ai/shared-workspaces.md).

The link opens a standalone page. Readers can still interact with captured Plotly charts, but they don't see evidence citations or sources.

* **Pipeline dashboards** keep the same link when you rename the pipeline, and readers can pick earlier runs. You can share a run before it finishes; its report appears when ready.
* **Standalone dashboards** link to the saved file.

To let readers see new data on live figures, see [Share live figure data](https://docs.quadrillion.ai/writeups.md#share-live-figure-data).


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