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.
We have separate support documents on managing Salesforce org connections and managing source control connections.
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 metadatapage (https://app.gearset.com/configure). To get there from elsewhere in the app, it's underMetadata deploymentsin the left-hand side menu.
Under
Choose source metadata location, clickSalesforce 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 connectionbutton to authorize it:
Repeat for your
target metadata location.
Once you have selected a source and target, the
COMPARE NOWbutton will become enabled.
Click
COMPARE NOWto 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.