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

# Matchingrule

**Class: ** `metadata`

Matching Sharing Rules are part of Dynamic Access Control for objects. These rules allow assignment of users to Auto Managed groups and dynamic assignment of those groups to roles on specific object records.

Learn about <a href="https://platform.veevavault.help/en/lr/36122" target="_blank">Configuring Matching Sharing Rules for Objects in Vault Help</a>.

| Attribute | Metadata | Description |
| --- | --- | --- |
| label | Type: StringRequiredMax length: 100 | UI-friendly string in the Vault's base language. |
| active | Type: BooleanRequired | Indicates whether the field is active. |
| description | Type: StringMax length: 255 | General description of the matching rule. |
| object | Type: ComponentRequired | The object the rule applies to. |
| role | Type: StringRequiredMax length: 60 | The role the rule applies to. |
| user_role_fields | Type: StringRequiredMax length: 56Multi-value | A list of User Role Object Fields used to identify matching rows. |
| data_fields | Type: StringRequiredMax length: 56Multi-value | A list of Object or Document Fields used to identify matching rows. |

### 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:** [Link](/safety/mdl/component-types/link)  
**Next:** [Messagedeliveryeventhandler](/safety/mdl/component-types/messagedeliveryeventhandler)