# Dashboards (/docs/product-analytics/dashboards)

A dashboard is a grid of cards you arrange yourself: headline numbers, charts, saved insights, notes and live widgets. Dashboards are shared with everyone in the project. The project **Home** page is a dashboard too.

## Build a dashboard [#build-a-dashboard]

1. **Dashboards → New dashboard.** Start blank, or from **Overview** with headline metrics, active people and top events.
2. Click **Add** to open the card library.
3. Click **Customize** to drag cards by their title and resize them from the bottom-right corner. Changes save as soon as you let go.

The library has:

| Card | Shows |
| --- | --- |
| **Metric** | One big number with the change against the previous period and a sparkline. Ready-made ones include active people, sessions and pageviews. **Custom metric** lets you pick any event and measure, such as the sum of `amount` with a `$` prefix. |
| **Chart** | A trend, funnel or retention chart that lives on the dashboard. You don't need to save it as an insight. |
| **Insight** | A saved insight. Edit the insight to change it. |
| **Text** | A section heading or a note. |
| **Widget** | Top events, the live event stream or recent changes. |

The **date range** and **Compare to previous period** at the top apply to every card, and they're saved with the dashboard.

On phones, the grid becomes a list: metrics two per row, everything else full width, in the same order. Rearrange cards on a desktop.

## Home page [#home-page]

A new project's **Home** page is an Overview board: four headline metrics, daily active people, top events, live events and recent changes. Customise it like any other dashboard.

To make another dashboard your home page, open it and choose **⋯ → Use as home page**.

## Share a public link [#share-a-public-link]

**Share** creates a read-only link like `https://app.datahop.dev/share/shr_…`. Anyone with the link sees the dashboard live, without an account, and can switch between 24h, 7d, 30d, 90d and 12m.

- **Shown:** card titles, numbers, charts and their labels, headings, notes and top events.
- **Never shown:** queries and filters, cohort definitions, individual people, raw events or your project token. The live events and recent changes widgets are left out.
- Numbers refresh every minute.
- Links unfurl in Slack, X and iMessage with the dashboard and project name.

**Reset link** issues a new URL and turns off the old one. Switching sharing off turns off the link too. With a [custom domain](/docs/getting-started/project-settings#custom-domain), share links use your domain.

## Ask an agent [#ask-an-agent]

Agents can build and read dashboards too. For example: *"Build a SaaS health dashboard with weekly signups by source, the signup → project → invite funnel, weekly retention and upgrade revenue."* An agent reads a whole dashboard in one call, card by card, through the same summaries you see. See [Agents](/docs/agents).