**Source URL:** https://general.veevavault.dev/commercial/mdl/component-types/dashboard.md

# Dashboard

**Class: ** `metadata`

Dashboards provide an at-a-glance understanding of key metrics.

Learn about <a href="https://platform.veevavault.help/en/lr/8934" target="_blank">Dashboards in Vault Help</a>.

| Attribute | Metadata | Description |
| --- | --- | --- |
| active | Type: Boolean | Indicates whether the component is active. |
| label | Type: StringRequiredMax length: 128 | UI-friendly string in the Vault's base language. |
| description | Type: StringMax length: 255 | A general description of the dashboard. |
| editors | Type: StringMax length: 300Multi-value | Users with the Editor permission required to edit dashboards. |
| viewers | Type: StringMax length: 300Multi-value | Users with the Viewer permission required to view dashboards. |
| owners | Type: StringMax length: 300Multi-value | Lists users and groups in the Owner role. Users in this role can assign other users and groups to the Owner role on Dashboards. |
| dashboard_markup | Type: XMLStringRequiredMax length: 32000 | Describes the layout of the dashboard. |
| tags | Type: StringMax length: 1500Multi-value | A list of tags associated with the dashboard. |

### Supported Operations {#supported-operations}

| Operation | Support |
| --- | --- |
| Create | Yes* |
| Recreate | Yes* |
| Alter | Yes* |
| Drop | Yes |
| Rename | Yes |
| Describe | Yes |
| Generate Recreate | Yes |
| Queryable | No |
**Notes:**

<ul style="padding-left:1.5em;margin-top:0.5rem"><li>**Create, Recreate, Alter:** <span>MDL Operation is supported, but the Component Type contains field(s) that use proprietary XML. Direct modification of the XML is not supported or recommended. Instead, creating and/or updating the component is better suited through the Admin UI.</span></li><li>**Alter:** <span>MDL Operation may not be supported for some multi-value attributes.</span></li></ul>


---

**Previous:** [Customwebapi](/commercial/mdl/component-types/customwebapi)  
**Next:** [Docatomicsecurity](/commercial/mdl/component-types/docatomicsecurity)