**Source URL:** https://limited.veevavault.dev/clinical/mdl/component-types/report

# Report

**Class:** `metadata`

Represents a Vault report.

Learn about [Reporting in Vault Help](https://platform.veevavault.help/en/lr/3631).

| Attribute | Metadata | Description |
| --- | --- | --- |
| `label` | Type: String **Required** Max length: 128 | UI-friendly string in the Vault's base language. |
| `active` | Type: Boolean **Required** | Indicates whether the component is active. |
| `description` | Type: String Max length: 255 | A general description about the report. |
| `format` | Type: Enum **Required** Allowed values: tabular; matrix | The output format of the report. For example, a Tabular or Matrix report. |
| `definition` | Type: XMLString **Required** Max length: 32000 | The query to use to pull the data. |
| `layout` | Type: XMLString **Required** Max length: 32000 | The layout of the data. |
| `content_type` | Type: Enum **Required** Allowed values: Document; Workflow; ReadAndUnderstand; Distribution; Bindernode; Object; Relationship; MatchedDocument; Binder; BinderSection; MultiPass; Union | 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: String Max length: 1500 Multi-value | Lists users and Groups in the *Editor* role. Users in this role can edit reports. |
| `viewers` | Type: String Max length: 1500 Multi-value | Lists users and Groups in the *Viewer* role. Users in this role can view reports. |
| `owners` | Type: String Max length: 1500 Multi-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: Enum Allowed values: Standard; View | 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: String Max length: 1500 Multi-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

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

**Notes:**

*   **Create, Recreate:** 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.

---

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