Skip to main content

Combine multiple deployments into one single deployment package

Guidelines on how to combine multiple completed deployments into a single deployment package, and deploy to the same or another target

Valerio Chang avatar
Written by Valerio Chang
Updated this week

License requirements:
To use this feature, a user needs either Deployment Teams or Enterprise license assigned.

With Gearset’s clone package feature, you can promote successful changes to the next environment in your release pipeline. While this was, and still is, a huge time-saver, if you wanted to migrate changes from multiple deployments, you’d have to clone each in turn, or start from scratch with a fresh comparison.

To eliminate this and keep up the speed of your release cycle, Gearset allows you to combine multiple deployments into one package.

Kicking off a combined deployment within Gearset

To get started, head to the Deployment history page. Choose which deployments you’d like to combine by selecting the checkboxes in the left-hand column, then click Combine packages at the bottom of the page.

The resulting dialog lets you review and confirm the deployments you’re combining, and choose the source and target environments for the combined deployment you can select from both Salesforce orgs and version control.

Before you kick off the comparison, in the Metadata filter tab, you can choose from one of the two options:

  • Default (Gearset will combine the filter used in each of the deployments you are combining), or

  • Specify a custom filter (allow you to select a pre-defined Gearset filter, or one of your own custom filters)

Once you've run the comparison, the items from each combined deployment will be pre-selected for you in the new comparison results grid.

From this point, the deployment behaves like any other in Gearset. You can:

• Add or remove items from the deployment

• Refresh the comparison

• Save a draft

• Continue to validation or deployment

All without needing to repeat the steps for each original deployment

To find out more about how Gearset determines which metadata items are selected, please refer to this guide:

If there are conflicts between the same metadata item in the combined package, what does the resulting package contain?

Remember, Gearset's clone deployment works by running a fresh comparison, so you don't run the risk of overwriting changes.

• Gearset runs a new comparison between your selected source and target

• It automatically pre-selects components by name based on what was deployed in the selected past deployments

• You’ll then see up-to-date comparison results and can review each change before deployment

Only the list of item names is carried over from the combined packages. The actual XML metadata is pulled from the current source environment, ensuring your deployment is accurate and up to date.

A note about org types

This feature works for Salesforce orgs authenticated via any of the available "Connection type":

  • Sandbox org (Dev, Prod or Full), connected via test.salesforce.com

  • Production or Developer Edition org, connected via login.salesforce.com

  • Custom domain, connected via <your-url>.salesforce.com

Did this answer your question?