Skip to main content
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 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:

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.
  • 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.
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 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. 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.