> For the complete documentation index, see [llms.txt](https://knowledgebase.autorabit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.autorabit.com/product-guides/vault/vault-features/masking-rules/clone-masking-rules-to-objects-user-guide.md).

# Clone Masking Rules to Objects User Guide

**AutoRABIT Vault User Guide**

This guide explains how to clone existing masking rules to fields on one or more destination objects, review the rules that Vault will create, start the cloning operation, and monitor or retry the resulting bulk clone jobs.

## How rule consolidation works

Vault creates cloned rules by destination object and compatible field type. Within a destination object, selected fields with the same field type are combined under one cloned rule. The resulting rule retains the masking style and masking value of the selected source rule.

| **Observed selection**                  | **Result**               | **Interpretation**                                                                                         |
| --------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| 6 picklist fields on AccountTeamMember  | 1 rule masks 6 fields    | All six fields share the picklist type and are combined into one rule.                                     |
| 133 fields across 5 destination objects | 12 rules mask 133 fields | Vault counts each distinct compatible field type within each destination object as a separate cloned rule. |

{% hint style="info" %}
**Important:** The number of rules that will be created is not the same as the number of selected fields. It is the sum of applicable field-type groups across the selected destination objects.
{% endhint %}

## Before you begin

* Confirm that the required source masking rules exist in the selected Salesforce org.
* Identify the destination objects and fields to which the rules must be cloned.
* Ensure each destination field has the same field type as the selected source rule.
* Review fields marked as already having masking configured; these fields are not available for a new cloned assignment in the observed flow.

## Open the clone workflow

{% stepper %}
{% step %}

### Open Bulk Clone Rules

From the left navigation, expand Masking and select Bulk Clone Rules.
{% endstep %}

{% step %}

### Select the Salesforce org

Select the Salesforce org and select Apply.
{% endstep %}

{% step %}

### Open Clone to Object

Select Clone to Obj to open the Clone Masking Rules to Objects workflow.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FCBsMwiITJ9jErbR3bfl9%2Fimage.png?alt=media&amp;token=4ff9507a-1dd7-4cec-b229-4b65c3c911cf" alt=""><figcaption></figcaption></figure>

**Bulk Clone Rules page and Clone to Obj action**
{% endstep %}
{% endstepper %}

## Select source masking rules

The Select Rules step lists available masking rules from the selected source org.

{% stepper %}
{% step %}

### Locate the source rule

Use the object filter or search controls to locate the required source rule.
{% endstep %}

{% step %}

### Select a masking rule

Select a masking rule. Only one rule for each field type can be selected.
{% endstep %}

{% step %}

### Continue

Review the selected-rule count and select Continue.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FW1AiZGTIWOFncJrRFQkR%2Fimage.png?alt=media&amp;token=8e42c287-8733-4e98-b101-257a3d79c178" alt=""><figcaption></figcaption></figure>

**Available source masking rules**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F810z2mvlkS0ujGypY6Em%2Fimage.png?alt=media&amp;token=eeff9f3b-271d-4c02-8bfb-104e9f644d1e" alt=""><figcaption></figcaption></figure>

**One source masking rule selected**
{% endstep %}
{% endstepper %}

## Add destination objects

The Destination Objects step is used to select target objects and configure compatible fields for each object.

{% stepper %}
{% step %}

### Add an object

Select Add Object.
{% endstep %}

{% step %}

### Select destination objects

Search for or select the required destination objects.
{% endstep %}

{% step %}

### Add selected objects

Select Add to include the objects in the destination configuration.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FecQLRQBYEoY9tblRCq3C%2Fimage.png?alt=media&amp;token=f1a4d652-6b13-4cc9-982e-85bb6da66205" alt=""><figcaption></figcaption></figure>

**Destination Objects step before objects are added**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FJr0eTGUSjryw4RujmXOC%2Fimage.png?alt=media&amp;token=7de0b15a-ec9c-439d-819f-22486ea48012" alt=""><figcaption></figcaption></figure>

**Object Selection dialog**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FfhjMsYYQxUk8cwStM4fh%2Fimage.png?alt=media&amp;token=800e4f1d-f923-413d-845b-2032ade3913f" alt=""><figcaption></figcaption></figure>

**Destination object search and available objects**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FPmO4WsH6AC3K52iu35PB%2Fimage.png?alt=media&amp;token=a4299cbe-c6c6-4f90-91ea-5ad0200714fb" alt=""><figcaption></figcaption></figure>

**Two destination objects selected**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FoMXrQRT5JipzxWqRZ2U5%2Fimage.png?alt=media&amp;token=e6576cf6-9a68-4473-9f0f-2428c411fa13" alt=""><figcaption></figcaption></figure>

**Maximum of five destination objects selected**
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Observed limit:** The interface allows up to five destination objects in one clone operation. To choose another object after reaching the limit, unselect an existing object first.
{% endhint %}

## Select compatible destination fields

Select each destination object tab and choose the fields that must receive the cloned rule. Vault applies a source rule only to destination fields of the same field type and displays a clone preview for the active object.

{% stepper %}
{% step %}

### Open a destination object

Open a destination object tab.
{% endstep %}

{% step %}

### Select eligible fields

Select one or more eligible fields. Fields that already have masking configured are identified in the field list.
{% endstep %}

{% step %}

### Configure remaining objects

Repeat the selection for each destination object.
{% endstep %}

{% step %}

### Confirm configured objects

Confirm that the configured-object count reflects every intended destination object.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FxCc4HbEPeW349bKPYF0p%2Fimage.png?alt=media&amp;token=299d1c21-8837-49a3-8488-702d3eb29030" alt=""><figcaption></figcaption></figure>

**Configured destination objects and object-level clone preview**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FskYS8lHPsDbZyjLzL8Ie%2Fimage.png?alt=media&amp;token=eeb0cab3-82fe-4010-bded-7b3f3a87221e" alt=""><figcaption></figcaption></figure>

**Fields with existing masking and required field selection**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fm3sw7Ah2JXTR6i3ACHvk%2Fimage.png?alt=media&amp;token=bf970e39-7b67-4209-8a69-ae23224f3750" alt=""><figcaption></figcaption></figure>

**Case preview showing field groups and cloned rule names**
{% endstep %}
{% endstepper %}

## Understand the object-level readiness summary

For AccountTeamMember, all six selected fields are picklist fields. Because they share the same compatible field type, Vault groups them under one cloned substitution rule.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FwfKj4iVFxL7vnOm8jsDg%2Fimage.png?alt=media&amp;token=da215823-1c2b-4239-bc95-7fc7a8ae8b4f" alt=""><figcaption></figcaption></figure>

**Six selected picklist fields on AccountTeamMember**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FODGr1h9MGwXQyd6H34i5%2Fimage.png?alt=media&amp;token=85151022-3e6d-4f6b-8127-20c68c4f5034" alt=""><figcaption></figcaption></figure>

**One cloned rule configured to mask six AccountTeamMember fields**

**Displayed summary:** Ready to clone: 1 rule will be created, masking 6 fields on AccountTeamMember.

## Review the complete clone summary

Select Continue to open Summary. Review the source org, selected masking rules, destination objects, field-to-rule mappings, masking styles, source objects, and clone eligibility before starting the operation.

{% stepper %}
{% step %}

### Confirm source rules

Confirm that each selected source rule shows the expected field type, masking style, and Cloneable status.
{% endstep %}

{% step %}

### Review destination objects

Review each destination object and its selected field count.
{% endstep %}

{% step %}

### Verify rule mappings

Verify the source-to-cloned rule names and the masking style assigned to each field.
{% endstep %}

{% step %}

### Start cloning

Review the final Ready to clone summary and select Clone.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FKXvqiM6mjJ3KQNHPgTLh%2Fimage.png?alt=media&amp;token=23c45716-550f-4aa8-aff5-a44ce3efb5b9" alt=""><figcaption></figcaption></figure>

**Summary with source rules, destination objects, and clone preview**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FV8NdKOww0H6wYMpDtKnq%2Fimage.png?alt=media&amp;token=78a8b320-70c6-443f-9c7d-7ae943b84760" alt=""><figcaption></figcaption></figure>

**Summary mappings for Case, Opportunity, and Account**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FTnNCbWbhwEhpDmiizch4%2Fimage.png?alt=media&amp;token=50e4ced7-930e-46c9-a173-a5fa6de50792" alt=""><figcaption></figcaption></figure>

**Summary mappings for Account and AccountTeamMember**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FDwBzGqPQ0S8t6WLhzj3X%2Fimage.png?alt=media&amp;token=eb8b3e8a-6689-4c9d-b7f2-94f2f3deec27" alt=""><figcaption></figcaption></figure>

**Final readiness summary across five destination objects**
{% endstep %}
{% endstepper %}

**Displayed summary:** Ready to clone: 12 rules will be created, masking 133 fields across 5 objects.

## Start and monitor the clone operation

After Clone is selected, Vault confirms that the operation was initiated and directs the user to Masking > Bulk Clone Rules. A separate job is created for each destination object.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FeKzEmamlaLQr2iymeWby%2Fimage.png?alt=media&amp;token=e35f5034-f37a-402a-bb0e-bc98f2414bb5" alt=""><figcaption></figcaption></figure>

**Clone operation initiated successfully**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FoQQbPxvGfDPIaGL1YgE5%2Fimage.png?alt=media&amp;token=a107e0e6-b517-4f76-9e9a-f95ecf5bfaea" alt=""><figcaption></figcaption></figure>

**Bulk clone jobs created for the destination objects**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F3q5OZ68V3v3LgnrFo3sx%2Fimage.png?alt=media&amp;token=8fa4d63b-cf79-4190-9ab5-77365c15cfac" alt=""><figcaption></figcaption></figure>

**Bulk Clone Rules list with destination-specific jobs**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FJdn7cz33RvEaoYnVOoXW%2Fimage.png?alt=media&amp;token=3cf652c9-eb6e-4bea-a63a-210dfd0f855f" alt=""><figcaption></figcaption></figure>

**Job statuses and actions**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FNJuWu0cGgqhLfqi3KCdn%2Fimage.png?alt=media&amp;token=45b9b257-20c8-4c82-9fe3-092b112f5ac8" alt=""><figcaption></figcaption></figure>

**Available action for an unsuccessful bulk clone job**

## Retry an unsuccessful job

If a destination-specific bulk clone job does not complete successfully, use the Retry action for that job.

{% stepper %}
{% step %}

### Locate the unsuccessful job

Locate the unsuccessful job in Bulk Clone Rules.
{% endstep %}

{% step %}

### Retry the job

Select the Retry action and confirm the operation when prompted.
{% endstep %}

{% step %}

### Monitor the retry

Verify the confirmation message and monitor the updated Last Run Date, status, and retry result.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FtB6geXlJgopDnIp1427F%2Fimage.png?alt=media&amp;token=b4189d73-82d0-4ac6-98c8-3f677eff0c74" alt=""><figcaption></figcaption></figure>

**Retry initiated for the selected bulk clone job**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fs173sED3R6FlMwjNdeI6%2Fimage.png?alt=media&amp;token=91c921a5-4752-4f77-8678-5b697320305d" alt=""><figcaption></figcaption></figure>

**Bulk clone job list after retry**
{% endstep %}
{% endstepper %}

## Review bulk clone job details

Use the job information action to review the bulk job ID, operation type, destination, overall status, retry count, and field-level outcomes. The details identify the source and cloned rule, object, masking style, masking value, and remarks for each field.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FdsJ6ZamXr7SeiSv7OHpl%2Fimage.png?alt=media&amp;token=fb54b52c-2c76-4606-b178-d24ebbf3d9b5" alt=""><figcaption></figcaption></figure>

**Bulk clone job information**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FmwUCVhtv4zteHnLYg0B5%2Fimage.png?alt=media&amp;token=92695b98-84f6-4973-8e5e-7375b7bc5085" alt=""><figcaption></figcaption></figure>

**Partially failed job with field-level remarks**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FcyMyIoMpJdrmeV4vOp1u%2Fimage.png?alt=media&amp;token=47bf2569-27c1-44aa-a453-398bd4b41942" alt=""><figcaption></figcaption></figure>

**Bulk Clone Rules list after job-detail review**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FPepkyAkxJE7DPl66Wu2j%2Fimage.png?alt=media&amp;token=6b55724f-7b81-45c1-a4e7-c03cc63afffe" alt=""><figcaption></figcaption></figure>

**Detailed field mappings and masking values**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FbCE1lhJH02kTiv5zRKNt%2Fimage.png?alt=media&amp;token=08ceceec-9831-4f72-8afc-ba2260830406" alt=""><figcaption></figcaption></figure>

**Additional field-level job information**

## Interpret job results

| **Result**            | **Recommended review**                                                                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Successfully cloned   | Confirm that the expected cloned rule and masking style are shown for the field.                                                                              |
| Partially Failed      | Review Remarks to identify failed fields, correct the reported configuration issue, and retry the destination-specific job.                                   |
| Invalid masking value | Verify that the source masking value is valid for the corresponding destination field. Picklist values must be valid for the destination field configuration. |

## Key points

* Only one source masking rule can be selected for each field type.
* A source rule can be applied only to destination fields with the same field type.
* Within one destination object, compatible fields of the same type are combined into one cloned rule.
* The same cloned rule can therefore mask multiple fields on that destination object.
* The total rule count is calculated across the field-type groups of all selected destination objects.
* Each destination object is tracked through its own bulk clone job, allowing object-specific monitoring and retry.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://knowledgebase.autorabit.com/product-guides/vault/vault-features/masking-rules/clone-masking-rules-to-objects-user-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
