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

# Overview

> Build custom dashboards from workspace metrics and share them with your team.

Dashboards let you build your own views of your workspace. Pick the metrics you care about, turn each one into a chart, arrange them on a grid, and either share the dashboard with your workspace or keep it private.

Open **Dashboards** from the workspace section of the sidebar, just below **Overview**. You can also jump to any dashboard through workspace search (**⌘ K** / **Ctrl+K**).

## The dashboard list

The list shows every dashboard you can access as a card with its icon, name, description, and widget count. A **lock** icon marks a **private** dashboard.

Select **New dashboard** to create one.

## Create a dashboard

In the create dialog, set:

* **Name** and **description**
* **Icon** and **color**
* **Visibility** - **Workspace** (everyone in the workspace can open it) or **Private** (only you)

Save, and Pike opens the new, empty dashboard so you can add your first widget.

## The dashboard view

At the top of a dashboard you'll find its icon and name, and a **date range** picker.

The date range drives everything: every widget on the page is calculated for the range you pick. It defaults to **This year**. The range is personal to you and isn't saved - it resets to This year each time you open the dashboard. Clear it and the page shows a "select a date range" prompt instead of loading data.

Below the header sits the widget grid. An empty dashboard shows a set of **recommended templates** to start from.

<Card title="Widgets" icon="chart-simple" iconType="regular" href="/docs/dashboards/widgets">
  Add widgets, choose a chart type, group your data, and filter it.
</Card>

## Download as Excel

You can export a whole dashboard to an Excel file. Pike creates one sheet per widget, each holding that widget's data for the date range you've picked, so a dashboard with six charts becomes a workbook with six sheets. Restricted metrics come through as an empty sheet noting the metric was restricted.

## Who can edit

Workspace **admins** and the person who **created** the dashboard can edit it - rename it, change its widgets, and delete it. Everyone else opens it in **view-only** mode.

Private dashboards are only visible to their creator.

## Metric permissions

Widgets respect your workspace role. If a widget uses a metric you're not allowed to see, it shows **Restricted metric** instead of the data - the rest of the dashboard still loads normally.

## Next steps

<CardGroup cols={2}>
  <Card title="Widgets" icon="chart-simple" iconType="regular" href="/docs/dashboards/widgets">
    Everything about building and managing widgets.
  </Card>

  <Card title="Metric catalogue" icon="list" iconType="regular" href="/docs/dashboards/metric-catalogue">
    Every metric you can chart, and exactly how each is calculated.
  </Card>
</CardGroup>