**Source URL:** https://limited.veevavault.dev/safety/mdl/component-types/sharingrule

# 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 [Custom Sharing Rules in Vault Help](https://platform.veevavault.help/en/lr/25494).

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

### Sharingrole

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

### Supported Operations

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

**Notes:**

*   **Alter:** MDL Operation may not be supported for some multi-value attributes.

---

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