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

Enable Org Shape for Scratch Orgs

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

Available in: Developer, Group, Professional, Unlimited, and Enterprise editions

Not available in: Scratch orgs and sandboxes

Be sure to:
  • Enable Org Shape for Scratch Orgs in both the source org and the Dev Hub org, if you want to capture the shape of an org that isn’t also your Dev Hub org.
  • When entering the org ID, use only the first 15 characters rather than the full 18-character org ID.
  1. Enable Org Shape for Scratch Orgs in the Dev Hub org that you use to create scratch orgs. Contact a Salesforce admin if you require assistance.
    1. From Setup, enter Org Shape in the Quick Find box, then select Org Shape.
    2. Click the toggle for Enable Org Shape for Scratch Orgs.
    3. In the text box, enter the 15-character org ID for the Dev Hub, then click Save.
  2. (Optional) If the source org is different from the Dev Hub org, enable Org Shape for Scratch Orgs in the source org.
    1. Log in to the source org.
    2. From Setup, enter Org Shape in the Quick Find box, then select Org Shape.
    3. Click the toggle for Enable Org Shape for Scratch Orgs.
    4. Enter the 15-character Dev Hub org ID that you’re using to create scratch orgs.
You can specify up to 50 Dev Hub org IDs to address these common use cases:
  • You have multiple production orgs but your development team has access to only one. For the customization they're building, they require the shape of another production org.
  • Your developers use their own Dev Hub orgs and don't have access to the production org. However, they want to create scratch orgs based on the shape of the production org.
  • You're an ISV who uses your production org to create scratch orgs. You want to capture the shape of your first-generation packaging org so you can build second-generation packages.