**Source URL:** https://general.veevavault.dev/safety/mdl/component-types/report.md

# Report

**Class: ** `metadata`

Represents a Vault report.

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

| Attribute | Metadata | Description |
| --- | --- | --- |
| label | Type: StringRequiredMax length: 128 | UI-friendly string in the Vault's base language. |
| active | Type: BooleanRequired | Indicates whether the component is active. |
| description | Type: StringMax length: 255 | A general description about the report. |
| format | Type: EnumRequiredAllowed values:tabularmatrix | The output format of the report. For example, a Tabular or Matrix report. |
| definition | Type: XMLStringRequiredMax length: 32000 | The query to use to pull the data. |
| layout | Type: XMLStringRequiredMax length: 32000 | The layout of the data. |
| content_type | Type: EnumRequiredAllowed values:DocumentWorkflowReadAndUnderstandDistributionBindernodeObjectRelationshipMatchedDocumentBinderBinderSectionMultiPassUnion | Specifies the type of data the report refers to. |
| report_type | Type: Component | The Reporttype this instance of the report was created from. |
| editors | Type: StringMax length: 1500Multi-value | Lists users and Groups in the Editor role. Users in this role can edit reports. |
| viewers | Type: StringMax length: 1500Multi-value | Lists users and Groups in the Viewer role. Users in this role can view reports. |
| owners | Type: StringMax length: 1500Multi-value | Lists users and Groups in the Owner role. Users in this role can assign other users and groups to the Owner role on reports. |
| class | Type: EnumAllowed values:StandardView | Indicates whether the report is Standard or Multi-Pass. |
| excel_template | Type: Component | Indicates which, if any, Excel template is associated with the report. |
| fit_pdf_to_page | Type: Boolean | Indicates whether all columns should fit on a single page in the exported PDF. |
| tags | Type: StringMax length: 1500Multi-value | Any tags assigned to the report. |
| include_full_longtext | Type: Boolean | If true, Vault includes the full text of long text fields in exports. If false or omitted, exports only contain the first 250 characters. |
| include_full_richtext | Type: Boolean | If true, Vault includes the full text of rich text fields in exports. If false or omitted, exports only contain the first 250 characters. |
| include_richtext_html_tags | Type: Boolean | If true, Vault includes HTML markup in exports. This option is only available if include_full_richtext= true. |

### Supported Operations {#supported-operations}

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

<ul style="padding-left:1.5em;margin-top:0.5rem"><li>**Create, Recreate:** <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></ul>


---

**Previous:** [Renditiontype](/safety/mdl/component-types/renditiontype)  
**Next:** [Reportexceltemplate](/safety/mdl/component-types/reportexceltemplate)