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

# Sharingrule

**Class: ** `metadata`

Vault uses Sharing Rules to manage users' roles on specific object records by matching rule criteria to specific user assignments.

Note that the configruation of this component varies by Vault. Learn about <a href="https://platform.veevavault.help/en/lr/25494" target="_blank">Custom Sharing Rules in Vault Help</a>.

| Attribute | Metadata | Description |
| --- | --- | --- |
| criteria | Type: ExpressionMax length: 4000 | A VQL statement where clause that returns a list of records of the specified object type. |
| description | Type: StringMax length: 255 | A general description of the rule. |
| active | Type: BooleanRequired | Indicates whether the component is active. |
| object | Type: StringRequiredMax length: 46 | The type of object the rule applies to. |
| label | Type: StringRequiredMax length: 100 | UI-friendly string in the Vault's base language. |

### Sharingrole {#sharingrole}

| Attribute | Metadata | Description |
| --- | --- | --- |
| members | Type: StringMax length: 256Multi-value | A list of the groups and/or users that will be given the associated permission.  To specify users&#58; User.user@domain.com. To specify groups&#58; Group.public_key__v. |

### 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>**Alter:** <span>MDL Operation may not be supported for some multi-value attributes.</span></li></ul>


---

**Previous:** [Securityprofile](/commercial/mdl/component-types/securityprofile)  
**Next:** [Signaturepage](/commercial/mdl/component-types/signaturepage)