Create Scratch Orgs More Easily Using an Org’s 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 with minor assembly required.


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 group.

Where: This change applies to Lightning Experience, Salesforce Classic, and all versions of the Salesforce app in Developer, Enterprise, Group, and Professional editions.

How: Enable Org Shape for Scratch Orgs in the org whose shape you want to capture (source org).

  1. As an admin, log in to the source org.
  2. From Setup, enter Org Shape in the Quick Find box, then select Org Shape.
  3. Click Enable Org Shape for Scratch Orgs (Beta).
  4. If your source org is different from your Dev Hub org, enter the Dev Hub org ID to the list of allowed Dev Hub orgs.
  5. Create a scratch org shape for the source org.
  6. Create a scratch org definition file that contains the 15-character source org ID, the only required option.
      "orgName": "Salesforce",
      "sourceOrg": "00DB1230400Ifx5"
  7. Create a scratch org.