Skip to main content
All CollectionsCompare and deploy metadataMetadata filters
Refreshing metadata in Compare and deploy
Refreshing metadata in Compare and deploy

Easily refresh specific metadata types and components in Gearset

Anthony Farino avatar
Written by Anthony Farino
Updated over a week ago

In the upgraded UI of Compare and deploy feature, we've made it easy to pull a new version of specific metadata types and/or components in just a few clicks.

This can be accomplished via refreshing a specific metadata type or refreshing a single item in the comparison results.


​Refreshing specific metadata types

After running a comparison, it's common to make additional changes in your environment - but in many cases, it can be a bit redundant to re-run the entire comparison for metadata types that are not being modified.
​
With the option to refresh specific metadata types, you can maintain the results of your original comparison while only querying Salesforce for the metadata types that you would like to retrieve again.

To refresh a specific metadata type, simply navigate to the filter pane on the left side of the comparison results screen and select the refresh icon next to the metadata type that you would like to update.

There are two types of refreshes available - Quick refresh and Full refresh:

Quick refresh (recommended)

This option will only fetch recently changed metadata (by retrieving changes made since the last comparison), and uses cashed metadata for unchanged metadata to save time.

Full refresh

This option will fetch everything from your Salesforce org for the metadata type you're refreshing.

This option may be unnecessary if you can use Quick refresh, as it can take longer to retrieve metadata. But it can be useful, for example in scenarios when Salesforce does not update its timestamps correctly.


Upon selecting the refresh icon, the metadata type in question will briefly become greyed out. This shows that Gearset is loading the new results from Salesforce.
​

Refreshing a single item in a comparison

When in a comparison, if you discover that one component is incorrect, and you want to update it, it can feel redundant to run a new comparison to grab the latest version of that one component.

With the refresh item option, you can update the component and refresh it from within your existing comparison without having to re-run the whole comparison.

To refresh a single item, right-click on a component and select the "Fetch latest" option.

Below an example of how to fetch (retrieve) the latest changes for Account Custom object:

If multiple components are selected and you right-click on one of them, this will show an option of "Fetch latest for selected items".

Selecting this will refresh all the selected metadata components:

Once "Fetch latest for selected items" option is selected, you'll see the spinning icon next to each of the items, as shown below.
​

Refreshing all selected metadata types

If you have already selected a group of metadata types from the filter and would like to refresh all of those selected types at once, you can do so by hovering over the All types in filter button and clicking the Refresh all types icon when it appears.

Did this answer your question?