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 (Beta)
Enable Org Shape for Scratch Orgs (Beta)
Org Shape Permissions (Beta)
Create and Manage Org Shapes (Beta)
Scratch Org Definition for Org Shape (Beta)
Limitations for Org Shape (Beta)
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
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

Create and Manage Org Shapes (Beta)

Create an org shape to mimic the baseline setup (features, limits, and settings) of a source org without the extraneous data and metadata. You can have only one active org shape at a time. If the features, settings, or licenses of that org change, you can capture those updates by recreating the org shape.

Scratch org shapes are associated with a specific Salesforce release. Be sure to recreate the org shape after the source org is upgraded to the new Salesforce release.

Important

  1. Authorize both your Dev Hub org and the source org. Run this command for each org.
  2. Create the org shape for the source org. This command kicks off an asynchronous process to create the org shape.
  3. Check the status of the shape:create command.

    You can use the org shape after the status is Active:

Delete Org Shapes (Beta)

If you run the shape:create command again for this org, the previous shape is marked inactive and replaced by a new inactive shape. If you don’t want to create scratch orgs based on this shape, you can delete the org shape.