Cancel an in progress deployment or validation

If you need to cancel a Salesforce deployment or validation that is currently in progress — for example, because you need to deploy a higher-priority update, you realize the deployment will fail, or you see unexpected failures during validation — there are several ways to do so.

What Happens When You Cancel a Deployment

The Salesforce deployment process is a complex, multi-step operation designed to preserve data integrity. When you request a cancellation, the deployment does not stop immediately. Instead, it completes its current step and then processes the cancellation request and executes a rollback of any changes already applied.

How Long Does a Cancellation Take

Because canceling a deployment is itself a multi-step process, it can take some time to complete. The duration depends on several factors: the size of the deployment payload (number of metadata components), the number of components that need to be rolled back, and the relationships and dependencies between those components.
For example, if the deployment is currently processing a single metadata type that contains many files, the cancellation may not be triggered for a significant amount of time because the current step must complete first.

Why Is a Canceled Deployment Still Showing as In Progress

A canceled deployment may continue to show as "In Progress" for some time after the cancellation is requested. This happens because the cancel operation does not directly terminate the deployment process — it signals the process to cancel, and the process completes its rollback steps before changing status. How long this takes depends on the complexity of the rollback.

How to Check the Status of a Cancellation

To check the current status of a cancellation, use the Salesforce Metadata API's checkDeployStatus() method. Also review the article Change Set validation or deployment stuck in In Progress for additional guidance.