Create a Scratch Org Based on an Org Shape (Beta)

Features, settings, limits, and licenses determine what we refer to as an org’s shape. We know it’s not easy to build a scratch org definition that mirrors the features and settings in your production org. With Org Shape for Scratch Orgs, you can leave building the scratch org definition to us. After you capture the org’s shape, you can spin up scratch orgs based on it.

As a beta feature, Org Shape for Scratch Orgs is a preview and isn’t part of the “Services” under your master subscription agreement with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all, and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply equally to your use of this feature. You can provide feedback and suggestions in the Org Shape for Scratch Orgs Trailblazer community.

Note

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. See Scratch Org Definition for Org Shape (Beta) for more information about considerations during the Salesforce major release transition.

Important

Salesforce DX Developer Guide

Create a Scratch Org Based on an Org Shape (Beta)