Skip to main content

A note about Org monitoring showing changes made outside of Gearset

This document outlines how Gearset's Change Monitoring feature handles metadata components when changes occur outside of the Gearset.

Jacob Joshua avatar
Written by Jacob Joshua
Updated this week

Impact of External Changes on Gearset Change Monitoring

The core principle is that if any part of an item or its components is changed outside of Gearset, the entire item and all of its components are flagged in the change monitor comparison, even if Gearset also changed a single component.

Behavior Examples

Example 1: Mixed Changes to the Same Object

This illustrates how changes made by Gearset and changes made outside of Gearset (e.g., directly in the Salesforce UI or via another tool) are grouped together when they affect the same parent metadata item.

Category

Detail

Parent Item

Case object

Change 1 (External)

The SuppliedEmail field on the Case object was changed outside of Gearset.

Change 2 (Gearset)

The SuppliedName field on the Case object was changed via Gearset.

Result

Both changes will be shown in the comparison because they are components of the Case object. Gearset shows the whole object as having been modified.

Example 2: Interaction with Change Monitor Filters

This illustrates that the change monitor's behavior of showing the entire parent item overrides filters applied to individual component types within that item.

Category

Detail

Parent Item

Case object

Configuration

The change monitor filter excludes List Views.

Change 1 (External)

The SuppliedEmail field on the Case object was changed outside of Gearset.

Change 2 (External)

The AllOpenCases list view on the Case object was changed outside of Gearset.

Result

Both changes will be shown. Although the list view (AllOpenCases) was individually excluded by the change monitor filter, its parent item (Case object) was modified (via the SuppliedEmail field change), causing the entire Case object and all of its components (including the List View) to be shown in the comparison.

Did this answer your question?