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

# Dashboard overview

> The analytics home: workspace engagement metrics, the flow engagement trend, and recent flows.

The dashboard is the first screen you see after signing in. It shows how your flows are performing for the currently selected app: top-line engagement metrics, a started-vs-completed trend chart, and a list of your recent flows.

<CardGroup cols={2}>
  <Card title="Workspaces and apps" icon="building" href="/dashboard/workspaces-and-apps">
    Set up your workspace and create an app for each platform.
  </Card>

  <Card title="API keys" icon="key" href="/dashboard/api-keys">
    Create the SDK key your app uses to resolve flows.
  </Card>

  <Card title="Managing flows" icon="layer-group" href="/dashboard/flows">
    Create flows, understand drafts and published versions.
  </Card>

  <Card title="Placements" icon="bullseye" href="/dashboard/placements">
    Connect a published flow to a named point in your app.
  </Card>

  <Card title="Experiments" icon="flask" href="/dashboard/experiments">
    A/B test flow variants on a placement.
  </Card>

  <Card title="Custom fonts" icon="font" href="/dashboard/custom-fonts">
    Upload font families to use in your flows.
  </Card>
</CardGroup>

<Note>TODO: screenshot of the dashboard home (metric cards, Flow Engagement chart, Recent Flows table).</Note>

## What the dashboard shows

The page header reads **Dashboard** with the subtitle "Overview of your workspace's flow performance and recent activity". In the top right you have a theme toggle and a **New Flow** button that creates a flow and opens it in the editor.

### Time range selector

A single time-range control in the top right drives both the metric cards and the chart. The options are:

* **Last 3 months** (90 days)
* **Last 30 days** (30 days, the default)
* **Last 7 days** (7 days)

On small screens the control collapses into a dropdown with the same three options, and the default narrows to **Last 7 days** so the chart stays readable.

### Metric cards

Four cards sit at the top of the page:

| Card                  | What it shows                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Total Flows**       | All flows in your workspace. Tagged with a "Workspace" badge. This is a count, not a windowed metric, so it never shows a trend chip. |
| **Active Users**      | Distinct users who started or completed a flow in the selected window.                                                                |
| **Completion Rate**   | Average completion across all flows in the selected window.                                                                           |
| **Total Impressions** | Flow impressions across all placements in the selected window.                                                                        |

Each windowed card (Active Users, Completion Rate, Total Impressions) shows a small trend chip that compares the selected window against the previous equal-length window, for example `+12.3% vs prior`. The chip is hidden when there is no prior-period data to compare against, so a brand-new workspace shows the numbers without a trend.

These are high-level engagement numbers. For the exact event each metric is built from, see [Event taxonomy](/reference/event-taxonomy).

### Flow Engagement chart

Below the cards, the **Flow Engagement** area chart plots two series over the selected window:

* **Started**: flows users began.
* **Completed**: flows users finished.

The chart needs at least two days of activity in the window to draw a trend. With one day or less it shows "Not enough days of data to draw a trend" instead of a broken single-point line.

### Recent Flows

The **Recent Flows** table lists your five most recently updated flows with their name, type, and last-modified time. Each row links into the editor, and a **View All Flows** button takes you to the full flows list. If you have no flows yet, the table prompts you to create your first one.

## Everything is scoped to the selected app

All dashboard data is scoped to the app currently chosen in the **app switcher** in the sidebar. Switching apps re-scopes your flows, placements, experiments, and analytics to that app. If your numbers look wrong, the selected app is the first thing to check.

See [Workspaces and apps](/dashboard/workspaces-and-apps) for how apps work and how the switcher behaves.

## Common mistakes

* **Numbers look empty or wrong.** You are almost always on the wrong app. Open the app switcher in the sidebar and confirm the selected app is the one your placements and flows live under.
* **No data at all.** A new app has no analytics until the SDK starts sending events. Numbers stay at zero until real sessions arrive.
* **Expecting a trend chip on Total Flows.** Total Flows is a count, not a windowed metric, so it never shows a "vs prior" chip.

## Troubleshooting

| Symptom                                                | Likely cause                                  | Fix                                                                            |
| ------------------------------------------------------ | --------------------------------------------- | ------------------------------------------------------------------------------ |
| "Not enough days of data to draw a trend" on the chart | Fewer than two days of activity in the window | Widen the time range or wait for more sessions.                                |
| "Unable to load dashboard metrics"                     | The analytics backend was unreachable         | Reload the page. If it persists, the analytics service may be down.            |
| Metrics are all zero                                   | Wrong app selected, or no events ingested yet | Switch to the correct app; confirm the SDK is configured and presenting flows. |

## Related pages

* [Workspaces and apps](/dashboard/workspaces-and-apps)
* [Placement analytics](/dashboard/placement-analytics)
* [Event taxonomy](/reference/event-taxonomy)
