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

# Dashboard

> The Home dashboard shows live shoppers, headline metrics for the selected window, most viewed products, a live activity feed, and an evidence-based insight.

The Home dashboard answers three questions at a glance: how many shoppers are on the store right now, how much activity the store recorded in the selected time window, and what deserves a closer look.

Tutorial: Dashboard

1:32

The complete dashboard walkthrough — choosing a time window, the live shoppers and KPI cards, the most viewed table, the live feed, and the insight of the period.

Captions available via the player's CC control.
[Download the video](https://topten.mintlify.site/assets/videos/dashboard.mp4)
if the player does not load.

Open it from **Home** in the navigation menu. The page auto-refreshes every 10 seconds and pauses while the browser tab is hidden.

![The Live Product Insights dashboard: KPI cards with period comparisons, a live activity feed, and a note that cart additions are not orders](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/app-home.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=85177ae7dc2934cc7ef5ab68ac432e22)

## Choose the time window

The filter bar at the top of the page controls every section:

* **Today**
* **Yesterday**
* **Last 7 days** (default)
* **Last 30 days**
* **Custom range** — pick any start and end date

Each KPI also shows its change versus the previous equal-length period, so a custom range is always compared against a window of the same size. The bar shows when the data was last updated.

## Live shoppers

The hero card shows how many shoppers are on the store right now. This is the count of **active viewers**: distinct sessions that sent a heartbeat within the active window (60 seconds by default, configurable in [Settings](https://topten.mintlify.site/settings.md)). It is never the same number as views — see [Measurement](https://topten.mintlify.site/measurement.md) for the distinction.

## KPI cards

Three cards summarise the selected window:

| Card | What it counts |
| - | - |
| Product views | Valid product-view events. Refreshes within 30 minutes count once per session and product. |
| Cart additions | Add-to-cart events. These are events, not orders. |
| Orders | Orders in the window. Test orders are excluded unless you enable them in Settings; cancelled orders are always excluded. |

Each card carries a tooltip with its exact definition and a percentage change versus the previous equal-length period. The views card also shows a small sparkline of how the number moved through the window.

## Most viewed products

A horizontal-bar chart ranks products by views for the selected window, backed by a table with the same numbers. The table adds cart additions, orders, conversion, and current stock where that data exists. The conversion column appears only when order attribution is supported for the window, and stock shows a dash for products without tracked inventory.

## Live activity feed

A running list of recent product views and cart additions, newest first. It shows raw activity as it arrives — product, event, and when it happened.

## Insight of the period

Below the feed, the dashboard highlights its strongest finding: a severity badge, the evidence behind it with its time period, and a suggested next step. The card stays hidden when nothing clears the evidence bar — findings are never invented. The full list lives on the [Insights](https://topten.mintlify.site/guides/insights.md) page.

![Lower half of the dashboard: the insight of the period, the activity trend chart with its time window and update time, and the product leaders for the period](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/app-home-scrolled.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=a22bcf3eb35ee11a7965531d82c82e09)

## Activity trend

An area chart plots views and cart additions across the selected window. Windows up to three days are bucketed by hour; longer windows use day buckets, so a 30-day view reads as a daily trend. The chart footer repeats the time window and update time.

## Leaders this period

Four cards name the period's standouts: most viewed, most cart additions, most ordered, and top revenue. A card shows "Not enough data yet" until that metric has activity in the window.

## How revenue is defined

Product revenue = line price × quantity − line discounts, excluding taxes and shipping, minus refunds. Test and cancelled orders are excluded. The same definition appears in a footnote on the dashboard itself and in [Metric definitions](https://topten.mintlify.site/measurement.md).

> [!NOTE]
>
> If the page shows a setup checklist instead of data, the theme embed isn't
> active yet. Follow the three steps shown, or see
> [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).

## Related pages

* [Products](https://topten.mintlify.site/guides/products.md) — the full per-product story behind the most viewed table.
* [Insights](https://topten.mintlify.site/guides/insights.md) — the complete list behind Insight of the period.
* [Metric definitions](https://topten.mintlify.site/measurement.md) — every number on this page, defined exactly.


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