# Dashboard override

URL: /code/project-structure/dashboard-override · Id: `convention:dashboard-override`

> A Dashboard override replaces part of a derived Dashboard; without one, every scope's Dashboard compiles from its records.

A [Dashboard](/business/nouns/dashboard) override replaces part of a derived Dashboard; without one, every scope's Dashboard compiles from its records.

| Property | Value |
| --- | --- |
| Path | `dashboards/[dashboard].mdx` |
| Holds | [Dashboard](/business/nouns/dashboard) |
| Kind | file |
| Leaders | db-first, git-first |
| Team | [Operations Team](/agents/operations) |
| Written by | [Change.merge](/business/nouns/change/merge) |
| Compiled by | [StartupBuilder](/code/builders/startup) |

### Example
`dashboards/close.mdx` in a Startup repository. Closewise, a sample business, declares a `Close` Noun.

```mdx title="dashboards/close.mdx"
---
scope: finance/controller
title: Month-end close
---
<MetricTile metric="days-to-close" window="month" />
<DataTable noun="Close" where="balanced = false" sort="period" />
<TaskInbox role="finance/controller" />
<ApprovalSheet />
```

### Props
The frontmatter keys the file takes. The body is its prose.

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| `scope` | `string` | Yes | Whose Dashboard it is: the Startup, a Team or a Role, by path. |
| `title` | `string` | No | Its name. |

### Generates
[StartupBuilder](/code/builders/startup) compiles it into these records, Verbs and routes.

| Kind | What |
| --- | --- |
| Records | [Dashboard](/business/nouns/dashboard) |
| Verbs | [Dashboard.schedule](/business/nouns/dashboard/schedule) |
| Routes | None. |