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
Supported Scratch Org Editions and Allocations
Build Your Own Scratch Org Definition File
Create a Scratch Org Based on an Org Shape
Enable Org Shape for Scratch Orgs
Org Shape Permissions
Create and Manage Org Shapes
Scratch Org Definition for Org Shape
Troubleshooting for Org Shape
Create Scratch Orgs
Select the Salesforce Release for a Scratch Org
Push Source to the Scratch Org
Pull Source from the Scratch Org to Your Project
Scratch Org Users
Manage Scratch Orgs from Dev Hub
Scratch Org Error Codes
Sandboxes
Track Changes Between Your Project and Org
Development
Build and Release Your App
First-Generation Managed Packages
Second-Generation Managed Packages
Partner Licensing Platform (Developer Preview)
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

Troubleshooting for Org Shape

Here are some issues you may encounter and workarounds.
ERROR running force:org:shape:list: Error authenticating with the refresh token due to: inactive user
ERROR running force:org:shape:list: Error authenticating with the refresh token due to: expired access/refresh token
Description: A trial org from which you created the org shape has expired.
Workaround:
  1. Use sfdx force:auth:logout to log out and remove the expired org.
  2. Run sfdx force:org:shape:list again.
Can't create a Digital Experience Cloud Site Using Org Shape
Description: When you try to create a scratch org from an org shape that contains an Experience Cloud Site, you get an error.
Workaround: None.
Error While Creating Scratch Org Using a Shape
Description: You see this error when creating a scratch org using a shape.
Workaround: Generate a new shape using the force:org:shape:create command, then try again.
Shift Status Picklists Aren’t Populated When Using a Shape With Field Service
Description: When you create a scratch org from a shape with Field Service enabled, the Status field picklist for Shifts is empty.
Workaround: Use an org shape with field service disabled, then enable field service in the scratch org definition file settings.
Org Shape Feature Accepts Only 15-Character Org IDs
Description: You can use only 15-character org IDs when enabling Org Shape for Scratch Orgs and specifying the source org in the scratch org definition file. Org IDs are usually 18 characters long, which is what the force:org:list command displays.
Workaround: Use only the first 15 characters of a standard 18-character org ID when working with the Org Shape feature.