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

> ## Agent Instructions
> Orion is a collaborative analytics platform built by Gravity (bygravity.com). It connects to data warehouses, to Looker and dbt for existing business logic, and to a small set of external-context sources, and it lets teams ask questions in natural language to get shared analyses, dashboards, reports, and slide decks. The Connecting Data Sources page is the authoritative list of supported sources. When referencing Orion features, always link to the relevant documentation page. Orion is not open-source; it is a commercial SaaS product accessed at runorion.com.

# Dashboards

> Build an interactive, filterable view of an analysis

A dashboard is an interactive layout of KPI tiles, charts, tables, and narrative text built from one of your analyses. A report or a slide deck fixes its numbers in place. A dashboard does not. You can filter it, [investigate any number on it](/dashboards/investigate), and every card recalculates.

A dashboard is the product of one analysis, so it carries that analysis's results until the analysis runs again. To keep it current on a recurring basis, make it a [Workflow](/workflows/create) output, and every scheduled run updates it in place.

Reach for a dashboard when people will come back to the same numbers repeatedly. Reach for a report or deck when the finding is the point. See [Workflow Outputs](/workflows/outputs) for that comparison in full.

<Frame caption="Illustrative">
  <img src="https://mintcdn.com/gravity-8db392ea/EorhmmSL2xQ3UKcg/images/dashboards/dashboard-full.webp?fit=max&auto=format&n=EorhmmSL2xQ3UKcg&q=85&s=ad959783a3a6d45fbf1dd46c747df096" alt="A published dashboard titled Regional Service Centers, opening with a dark header that carries the reporting period, duration, office count and headline totals, and a filter row with Date Range, Region, and Office Status dropdowns. Below it, three highlighted KPI tiles for median wait, applications in queue, and worst-case wait, then four more KPI tiles, then a Turnaround and Backlog Trends section holding a line chart of median turnaround by month beside a combination chart of backlog against review rate" width="3200" height="2000" data-path="images/dashboards/dashboard-full.webp" />
</Frame>

## Creating a Dashboard

There are three ways to get one:

### From the output picker

Ask for something to share, but do not say what kind. Orion runs the analysis. Then it offers **Choose an output format**, with **Report**, **Slides**, **Dashboard**, and **Pinned Metrics**. Pick **Dashboard**, and Orion builds one from the analysis it just ran.

The picker is not automatic. A question answered in chat does not raise it on its own. It appears when Orion has a result to package and no format has a name yet.

<Frame>
  <img src="https://mintcdn.com/gravity-8db392ea/EorhmmSL2xQ3UKcg/images/dashboards/create-output-picker.webp?fit=max&auto=format&n=EorhmmSL2xQ3UKcg&q=85&s=85055cec11557c973dd836abc60ec88c" alt="A finished analysis in chat, ending with Orion asking which format works best. Below it, outlined in red, a card headed Choose an output format offers four illustrated tiles: Report, Slides, Dashboard, and Pinned Metrics" width="3200" height="2000" data-path="images/dashboards/create-output-picker.webp" />
</Frame>

### By asking

Ask in chat: "make me a dashboard of this", or "build a dashboard showing revenue by region with a date filter". If you ask before running an analysis, Orion runs the analysis first, so generation takes longer. A placeholder grid with a progress bar shows while the dashboard is assembled.

### As a Workflow output

Choose **Dashboard** as the output format when [creating a Workflow](/workflows/create). The Workflow keeps one dashboard at one URL. Each scheduled run refreshes the data and rewrites the narrative text from the new numbers. The layout and the filters stay the same. Until the first run completes, the dashboard's card on the project page shows **Result pending**.

## Working with the result in chat

The finished dashboard appears in the chat as a thumbnail card. Click the card, or its **Expand dashboard** button. The dashboard opens in a panel beside the chat. There you can use the [filters](/dashboards/explore), [investigate a number](/dashboards/investigate), publish the dashboard, or [edit it](/dashboards/edit).

If you iterate on the same dashboard across a conversation, Orion marks the older thumbnails as superseded, so you always know which card is current. When the dashboard is already open next to the chat, edits confirm with a compact **Dashboard updated** chip and the canvas refreshes on its own.

<Note>
  Every dashboard appears on the project page as soon as it is created, visible
  **Only You** until you share it. Publishing and visibility are covered in
  [Publish and Share](/dashboards/publish).
</Note>
