# Delta on PermissionSets

## Overview

Starting with Salesforce **API version 40**, deploying PermissionSets by default replaces the entire set in the destination org with the incoming metadata. This can result in the loss of existing permissions if not managed carefully.

By selecting the **Enable Delta on PermissionSets** option, AutoRABIT retrieves the existing PermissionSets from the Source Org or Source Branch and **appends only the new changes** to the deployment package—preserving existing permissions in the destination org.

![Enable Delta on PermissionSets UI](/files/3YI0as8nVSP3ixbQ36X5)

{% hint style="info" %}
**Important Note:**\
The **Enable Delta on PermissionSets** feature is available **only** in the **CI Job module**. It is **not supported** in EZ-Commit, EZ-Merge, or standalone Deployment modules.
{% endhint %}

***

## Scenario 1

* **Source Org:** A PermissionSet contains a permission to an **Apex class A**.
* **Destination Org:** The same PermissionSet already includes **Apex class B**.

### Behavior:

* **Without Delta Enabled:** The PermissionSet in the destination org is **replaced**, and only **Apex class A** remains.
* **With Delta Enabled:** The PermissionSet in the destination org is **appended**, so both **Apex class A** and **Apex class B** permissions exist post-deployment.

![Permission Set Behavior with Delta](/files/dpNpNZPGpiypLJ3VR4KS) ![Resulting Permission Set with Delta Enabled](/files/JjQx0dKGSDDTv01eLTm3)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.autorabit.com/product-guides/arm-1/troubleshoot/how-tos/enable-delta-on-permissionsets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
