Salesforce DX Developer Guide
jSummer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Metadata Coverage
Error: API Version Mismatch
CLI Version Information
Run CLI Commands on macOS Sierra (Version 10.12)
Error: No defaultdevhubusername org found
Unable to Work After Failed Org Authorization
Error: Lightning Experience-Enabled Custom Domain Is Unavailable
Limitations for Salesforce DX
Newer Version Available
Troubleshoot Salesforce DX
This guide is a work in progress. Log in to the Salesforce Trailblazer Community and let us
know if you find a solution that would help other users so that we can incorporate it.
-
Error: API Version Mismatch
If you update Salesforce CLI and try to push source from your local DX project to a scratch org, you see an API version error. -
CLI Version Information
Use these commands to view version information about Salesforce CLI. -
Run CLI Commands on macOS Sierra (Version 10.12)
Some users who upgrade to macOS Sierra can’t execute CLI commands. This is a general problem and not isolated to Salesforce DX. To resolve the issue, reinstall your Xcode developer tools. -
Error: No defaultdevhubusername org found
Let’s say you successfully authorize a Dev Hub org using the --setdefaultdevhubusername parameter. The username associated with the org is your default Dev Hub username. You then successfully create a scratch org without using the --targetdevhubusername parameter. -
Unable to Work After Failed Org Authorization
Sometimes you try to authorize a Dev Hub org or a scratch org using the Salesforce CLI or an IDE, but you don’t successfully log in to the org. The port remains open for the stray authorization process, and you can’t use the CLI or IDE. To proceed, end the process manually. -
Error: Lightning Experience-Enabled Custom Domain Is Unavailable
If you create a scratch org with force:org:create, and then immediately try to use it, you sometimes get an error after waiting a few minutes for the command to finish.