Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Enable Dev Hub Features in Your Org
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Track Changes Between Your Project and Org
See Changes Identified by Source Tracking
Pulling and Pushing Changes Identified by Source Tracking
Resolve Conflicts Between Your Local Project and Org
Get Change Information by Querying the SourceMember Object
Best Practices
Differences and Considerations
Development
Build and Release Your App
First-Generation Managed Packages
Second-Generation Managed Packages
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Track Changes Between Your Project and Org

As you develop on the Salesforce DX platform, run source tracking to see a list of components you create, update, or delete between your local project and a Salesforce scratch org or sandbox.
Source Tracking in Sandboxes is available in: Professional, Enterprise, Performance, Unlimited, and Database.com Editions

Source tracking in scratch orgs is available in: Professional, Enterprise, Performance, Unlimited, Database.com, and Developer Editions

User Permissions Needed
To track changes between your project and a sandbox: Manage Sandbox
To enable Source Tracking in sandboxes: Customize Application
In addition to listing the changes you make, source tracking makes it possible to:
  • Automatically track changes to metadata components, saving you from tracking them manually.
  • See changes pushed to a sandbox by other developers.
  • Push or pull changed source.
  • Identify and resolve conflicts between your local project and Salesforce prior to pushing or pulling source.

To see which metadata components support source tracking, check the Source Tracking column of the Metadata Coverage Report.

Before working with source tracking, ensure that you complete these prerequisites.
  1. Install the Salesforce CLI.
  2. Enable Dev Hub.
  3. Enable Source Tracking for Sandboxes.
  4. Create a DX Project.
  5. Create a scratch org or sandbox, or refresh a sandbox that was created prior to enabling source tracking for sandboxes.