Gearset lets you compare any two Salesforce organizations or source control repositories and see the configuration differences between them. If you're new to Gearset, running a metadata comparison is a great place to start. 

To run a comparison, you'll first need to add some connections to your Salesforce orgs and/or source control repos.

One way to do this is to go to the My connections section in the left-hand side menu, and click on either Salesforce orgs or Source control and services.

Alternatively, you can add Salesforce org connections directly on the Compare metadata page, as described below, in an example workflow comparing two Salesforce orgs.

  • Log into Gearset. It opens on the Compare metadata page ( To get there from elsewhere in the app, it's under Metadata deployments in the left-hand side menu.

  • Under Choose source metadata location, click Salesforce organization.

  • Enter the username for the org you want to connect to.

  • If the connection is one you’ve already added via the org connections page, you'll see a green tick next to the username. That connection will now be saved for easy re-use in future comparisons.

  • If you've yet to do that, you'll need to click on the Add new connection button to authorize it:

  • Repeat for your target metadata location.

  • Once you have selected a source and target, the COMPARE NOW button will become enabled.

  • Click COMPARE NOW to begin your comparison.

  • Gearset will now retrieve the metadata from your source and target orgs, and show you the differences. Depending on the size of your orgs, this can take a few minutes.

For more on configuring comparisons (including selecting version control branches as source or target in the comparison, or local files as source, and choosing metadata comparison filters), read our in-depth article here.

Want an overview of the results of your comparison? Read our guide on exploring comparison results.

Did this answer your question?