By enabling source tracking in Developer and Developer Pro sandboxes, Salesforce DX
tooling can automatically track new, changed, and deleted metadata components. You can then select
and determine which changes to move forward in the development cycle and release. For DX tooling
that uses a Salesforce DX project or source control repository, source tracking can aid in
conflict detection and resolution. And best of all, because source tracking identifies which
metadata components changed, you no longer have to manually keep track of changes.
You can enable source tracking in Developer and Developer Pro sandboxes in two ways: in your
production org for all sandboxes created from it, or for a specific sandbox. After you turn on
source tracking, you can disable it at any time.
- For all Developer and Developer Pro sandboxes—when you enable the feature in your
production org, all newly created and refreshed sandboxes use source tracking. Existing
sandboxes don’t have source tracking enabled until you refresh them.
- For a specific Developer or Developer Pro sandbox—if you don’t want to enable
source tracking in all sandboxes, or want to enable source tracking without refreshing the
sandbox, you can enable it directly in the sandbox from the Sandbox Settings Setup page.
Enable Source Tracking for All Developer and Developer Pro Sandboxes
Enable source tracking for all Developer and Developer Pro sandboxes in your production
org from the Dev Hub Setup page.
Required Editions
| Available in: Enterprise, Performance, and Unlimited Editions.
For Professional and Database.com Editions, you can only enable source
tracking directly in the sandbox. |
| User Permissions Needed |
| To view a sandbox: |
View Setup and Configuration AND Customize Applications |
| To create, refresh, activate, and delete a sandbox: |
Manage Dev Sandboxes (Developer or Developer Pro only) or Manage Sandboxes (all
sandbox types) |
-
Log in to the source (production) org.
-
From Setup, find and select Dev Hub.
If you don't see Dev Hub in the Setup menu, make sure that the source org is one of the
supported editions.
-
Select Enable Source Tracking in Developer and Developer Pro
Sandboxes.
-
Refresh any existing Developer or Developer Pro sandboxes to enable this feature.
Source tracking is automatically enabled for any newly created or refreshed Developer or
Developer Pro sandboxes.
You can disable this feature at any time by clicking the toggle. When the sandbox is
refreshed, all source tracking information is deleted.
Enable Source Tracking in a Specific Sandbox
Enable source tracking for a specific Developer or Developer Pro sandbox in its
Settings Setup page. This feature remains enabled in a cloned sandbox. If you refresh a sandbox,
you must re-enable this feature.
Required Editions
| Available in: Lightning Experience in Developer and Developer Pro sandboxes |
| User Permissions Needed |
| To view a sandbox: |
View Setup and Configuration AND Customize Applications |
| To create, refresh, activate, and delete a sandbox: |
Manage Dev Sandboxes (Developer or Developer Pro only) or Manage Sandboxes (all
sandbox types) |
-
Log in to the Developer or Developer Pro sandbox.
-
From Setup, find and select Sandbox Settings.
-
Click Enable Source Tracking in This Sandbox.
Metadata changes from this point forward are tracked, but existing metadata changes made
before you enabled this feature aren’t tracked. When the sandbox is refreshed, all source
tracking information is deleted. If you haven’t enabled source tracking in the production org
for all Developer and Developer Pro sandboxes, and you want the refreshed sandbox to use source
tracking, you must re-enable the feature in the Sandbox Settings page.
If you disable source tracking, it can take several days to clean up the source tracking
records. The process isn’t instantaneous. You can re-enable source tracking after the cleanup
process is finished.
