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

# Inbox

> Mentions, invitations, alerts, and questions waiting for you

The Inbox is your personal list of things that need your attention. Each row is one item, such as a mention in a chat, an invitation, or a datasource alert. Select a row to go to the thing it is about.

Everyone who signs in has an Inbox, whatever their role. You see your own items, and admins also see items addressed to the whole workspace.

> [!NOTE]
>
> The Inbox is not available on Orion trial workspaces.

## Open the Inbox

Select **Inbox** in the left sidebar. When you have unread items, a blue badge on the icon shows the count, up to 99+. With the sidebar collapsed, hover the entry to see the count spelled out, for example "Inbox (3 unread)".

The badge refreshes when you return to the browser window. Inside the Inbox, it updates as you read and dismiss items. The page header also shows the count, for example "3 unread".

## What Shows Up

| Item | Where it opens |
| - | - |
| Someone mentions you in a chat | The conversation |
| You are invited to a room | The room's conversation |
| You are invited to a project | The project |
| A datasource connection has a problem | The datasource page |
| A datasource was disabled | The datasource's **Impact** tab |
| A Git sync needs attention | The version control integration page |
| A wiki change is waiting for review | The pending wiki review page |
| A change to a Controlled dashboard, report or metric is waiting for your review | The review panel on the item |
| A change you sent for review was approved or rejected | The item |
| Someone else changed a metric, view or insight maker used by a dashboard you created or whose project you own (labeled **Used by your dashboards**) | The changed metric or view, or the dashboard for an insight maker change |
| A connected account needs to be reconnected | The connection page for that account |
| A Health issue, assignment, or digest | The issue, its project, a list of issues, or the Health page |
| Orion asks you about an unexplained move in a metric | A dialog on the Inbox page |

An item that happens more than once shows a count such as ×3 instead of a new row. A **High** mark flags the urgent ones. A timestamp such as 3m or 2d sits at the right of each row, and hovering it shows the full date and time.

A row with no destination stays on the Inbox when you select it. It is marked read and nothing else happens.

With Orion Health on, an issue notice opens the issue's project. When the fix can be made in place, it opens a side panel with an **Open in Health** link instead. If the issue cannot be loaded or fixed in place, it opens the Health page. A digest that names one issue opens that issue the same way. A digest that names several opens a side panel in the Inbox that lists up to 10 of them, top-ranked first, and selecting one opens it the same way. Below the list, **See N more in Health** (or **Open Health** when all are shown) opens the Health page. With Orion Health off, an issue notice or a digest opens the Health page.

## Work Through Your Items

New and unread items have a blue dot and a bold title. An item leaves the list on its own once its cause is resolved, for example when a datasource connection is healthy again. High items come first, then the newest. Each page holds 25 items, and **Load more** at the bottom fetches the next 25.

Select a row to open it. Opening an unread item marks it read. Hover a row, or tab to it, to show two icon buttons beside the timestamp:

* &#x20;**Mark as read**, which becomes  **Mark as unread** once the item is read
* &#x20;**Dismiss**, which removes the item from your Inbox

After you dismiss an item, a message reads "Notification dismissed" with an **Undo** button. The Inbox has no list of dismissed items, so use **Undo** right away if you dismissed one by mistake.

**Mark all as read** at the top right marks the unread items on the page as read. It handles at most 25 at a time. When more than 25 are loaded, it reads **Mark 25 as read**, and you select it again for the rest.

## Filter the List

Two controls above the list combine with each other:

* **All** and **Unread** limit the list by read state.
* **All types**, **Needs action**, **Recommendations**, and **Updates** limit it by kind of item.

With **Unread** selected and nothing to show, the Inbox says "You're all caught up" and "No unread notifications." With **All** selected and nothing to show, it says "No notifications yet". Beneath it, a hint reads "Mentions, workflow results, and datasource alerts will show up here." If the list cannot load, the Inbox shows an error with a **Try again** button.

## Answer a Question From Orion

When Orion cannot explain a move in one of your metrics, it asks you in the Inbox. Select the row to open the question in a dialog without leaving the page. The dialog is headed **Unexplained move** and names the metric and the size of the change.

If the answer changes something Orion believes, a **Why it matters** section names it. Under **What happened**, pick the closest cause. Unless the question brings its own choices, they are:

* A release or product change
* An outage or incident
* A campaign or promotion
* A data or pipeline change

For anything else, type in **Something else, or more detail** and select **Save answer**.

After you answer, a message reads "Answer saved. Orion uses it in the next review." and the row leaves the Inbox.


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