> For the complete documentation index, see [llms.txt](https://docs.cortex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cortex.io/improve/eng-intelligence/dashboards/custom.md).

# Custom dashboards

{% hint style="info" %}
Custom Dashboards is available to all customers as a Public Beta feature. You can provide us [feedback here](https://forms.gle/xazu6auWuMGqMKRt7).
{% endhint %}

Custom dashboards let you build shared views of the engineering metrics that matter most to your organization. Combine saved modules from across your data sources into a single, focused view, then share it with your team so everyone is working from the same picture.

Use custom dashboards to:

* **Aggregate metrics across sources** - Pull together modules from version control, deployments, incidents, project management, and more into one dashboard.
* **Tailor views by team or use case** - Build dashboards scoped to specific teams, workflows, or engineering goals, e.g. an OpEx review, a DORA deep-dive, a sprint health check.
* **Share insights across your org** - Dashboards are visible to anyone with the `View Eng Intelligence` permission, so stakeholders get the context they need without manual reporting.
* **Surface trends and drive action** - Spot bottlenecks, track progress toward goals, and make data-driven decisions from a single view.

**Example dashboards**

<table><thead><tr><th width="180.4140625">Dashboard</th><th>What it tracks</th></tr></thead><tbody><tr><td><strong>Team health</strong></td><td>PR cycle time, deployment frequency, and incident rate for a specific engineering team</td></tr><tr><td><strong>Delivery health</strong></td><td>Story points completed, PR throughput, and deploy frequency across a quarter<br><br></td></tr><tr><td><strong>Incident response</strong></td><td>MTTR, incident frequency, change failure rate, and deployment volume</td></tr><tr><td><strong>OpEx review</strong></td><td>DORA metrics, on-call load, and SLA compliance for leadership reviews</td></tr><tr><td><strong>Platform reliability</strong></td><td>Change failure rate, rollback frequency, and time to resolution by service</td></tr><tr><td><strong>Sprint overview</strong></td><td>Work items completed, cycle time, and PR review turnaround for a given sprint</td></tr></tbody></table>

## Creating a custom dashboard

### Prerequisites

1. You must have the `Configure Eng Intelligence` permission.
2. Make sure you have configured metric modules and saved them in Data Explorer.

**To create a custom dashboard**:

1. From the main sidebar, expand **Eng Intelligence**, then click **Dashboards**.
2. In the upper-right corner, click **Create Dashboard**.
3. In the Create dashboard side panel, do the following:
   1. Under **Dashboard name**, enter a name for the dashboard (required).
   2. Under **Description**, enter an overview of the dashboard.
   3. Under **Display icon**, select an icon to represent the dashboard.
   4. Click **Create dashboard**. The **Saved modules** side panel opens.
4. From the **Saved modules** side panel, select an existing metric module to add to your dashboard. After selecting a module, you're directed to the dashboard.
   * To create a new module, click **Create module** to open the Data Explorer, configure your metric, and save it as a module. Then navigate back to Dashboards to add it to your dashboard.
5. To add more modules, click **Add module**. Repeat as necessary.<br>

   <div align="left" data-with-frame="true"><figure><img src="/files/5Fsj7Zd1hF7zfuadiIAj" alt=""><figcaption></figcaption></figure></div>
6. To remove a module, click its **Remove icon**.

{% hint style="success" %}
You can add as many modules to a custom dashboard as you need.
{% endhint %}