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

# Workflows

> Automate a recurring analysis and the delivery of its results

A Workflow is an automation. It takes an analysis you have already validated, re-runs it on a schedule, and delivers the result to whoever needs it, without anyone opening Orion to make it happen.

They scale with the job. The simplest is one analysis, one schedule, one email. A larger one queries several sources, produces a slide deck and a CSV, decides for itself whether the numbers are worth flagging, and mails different people depending on the answer. Between those two extremes sits most of what a data team currently does by hand every Monday morning.

The recipe is fixed, and that is the point. A Workflow re-runs the notebook you already checked rather than working the analysis out from scratch each time, so the same queries and the same transformations produce this week's numbers. You are not asking a question twice and hoping the answers are comparable.

<Note>
  Workflows are in beta, marked **v2 Beta** in the product. Existing Workflows
  keep running, but expect the interface to keep moving.
</Note>

## Notebook vs Workflow

A Workflow starts from work you have already done in [Chat](/chat/basics-navigation). Get the analysis right there first, then automate it.

|                   | Notebook                                        | Workflow                                                     |
| ----------------- | ----------------------------------------------- | ------------------------------------------------------------ |
| How it is created | Captured automatically as an analysis runs      | Built from a notebook you choose to save                     |
| When it runs      | When you ask Orion to re-run it in chat         | On a schedule, or on demand                                  |
| Output            | Results inline in your conversation             | Reports, exports, or both, refreshed in place each run       |
| Who sees it       | You, and anyone you share the conversation with | Anyone with project access, plus whoever the Workflow emails |

## What a Workflow is Made Of

Open a Workflow and it lays itself out as a graph of steps, running top to bottom.

<Frame>
  <img src="https://mintcdn.com/gravity-8db392ea/qWskfNcHSUbyxNiX/images/workflows/workflow-graph.webp?fit=max&auto=format&n=qWskfNcHSUbyxNiX&q=85&s=fd377c30f862dfe8386f18a861bbdc47" alt="Workflow view showing a graph of connected steps: a Scheduled Run trigger, the analysis it runs, slide deck and podcast outputs, a CSV export, and an email notification step" width="1998" height="878" data-path="images/workflows/workflow-graph.webp" />
</Frame>

* **Trigger**: when the Workflow runs. A schedule, or you pressing Run Now.
* **Analysis**: the notebook that does the work. This is the recipe, frozen at the version you validated.
* **Outputs**: what gets produced. A report, a slide deck, a dashboard, an audio briefing.
* **Exports**: data rather than narrative, such as a CSV of the underlying rows.
* **Notification**: who hears about it, and what gets attached.

Click any step to configure it. The set of steps is not fixed either, so a Workflow can grow new outputs and notifications as the need appears.

<Note>
  Opening a Workflow requires Analyst or Admin on the project. Viewers cannot
  open one at all, not even read-only. Your level can come from a group, so
  being a Viewer elsewhere in Orion does not necessarily mean you are one here.
  See [Project Permissions](/core-concepts/projects#project-permissions).
</Note>

## Finding Your Workflows

Each project has a dedicated **Workflows** page listing everything in one place. You get to it from the project page: scroll to the **Workflows** strip below Shared Metrics and Published Content, and click **View all**. The strip itself shows only the six most recently run, and it is the way in, so it is worth knowing where it sits.

<Frame>
  <img src="https://mintcdn.com/gravity-8db392ea/qWskfNcHSUbyxNiX/images/workflows/project-workflows.webp?fit=max&auto=format&n=qWskfNcHSUbyxNiX&q=85&s=5ffe70d29726a644af5dedf542c518eb" alt="A project page with the Shared and Yours toggle near the top and the Workflows section highlighted at the bottom, below Shared Metrics and Published Content. The section carries a v2 Beta badge, a View all link, and one entry listing a weekly schedule, a succeeded status, and a last run two days ago" width="1999" height="992" data-path="images/workflows/project-workflows.webp" />
</Frame>

The Workflows page is where you actually work with them. **Shared** and **Yours** tabs separate the project's Workflows from your own, and you get search, card and list views, and sorting by name, creation date, or most recently run.

<Frame>
  <img src="https://mintcdn.com/gravity-8db392ea/SiIEgsQokdLOM4P4/images/workflows/workflows-page.webp?fit=max&auto=format&n=SiIEgsQokdLOM4P4&q=85&s=dbb794a0413e624be39b2377ef9fa56a" alt="The dedicated Workflows page with Shared and Yours tabs, card and list view toggles, a sort control set to Created, and a search field. Four workflow cards each show a preview of the workflow's graph, its name, creator, schedule, and last run" width="1753" height="910" data-path="images/workflows/workflows-page.webp" />
</Frame>

Each card previews the Workflow's graph, so you can tell a one-step report from a branching automation before opening anything, alongside its name, who created it, its schedule, the outcome of the last run, and when that run happened. A Workflow that has never run says so.

Workflows are also indexed in [Search](/core-concepts/search) under the Workflows filter.

A Workflow starts out private to its creator, which is why a new one appears under **Yours** rather than **Shared**. See [Sharing and Permissions](/workflows/manage#sharing-and-permissions) for how to change that.

## Next Steps

<CardGroup cols={2}>
  <Card title="Create a Workflow" icon="plus" href="/workflows/create">
    Turn a finished analysis into an automation, in the dialog or by asking
  </Card>

  <Card title="Outputs and Delivery" icon="paper-plane" href="/workflows/outputs">
    Formats, templates, publish URLs, and who gets emailed
  </Card>

  <Card title="Manage Workflows" icon="sliders" href="/workflows/manage">
    Schedules, run history, change history, and editing
  </Card>

  <Card title="Advanced Workflows" icon="code-branch" href="/workflows/advanced">
    Decision steps and using metrics as the source
  </Card>

  <Card title="Best Practices" icon="lightbulb" href="/workflows/best-practices">
    How to build automations that keep working
  </Card>
</CardGroup>
