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
Create Scratch Orgs
Select the Salesforce Release for a Scratch Org
Deploy Source From Your Project to the Scratch Org
Retrieve Source from the Scratch Org to Your Project
Scratch Org Users
Manage Scratch Orgs from the Dev Hub Org
Scratch Org Error Codes
Sandboxes
Track Changes Between Your Project and Org
Development
Build and Release Your App
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

Manage Scratch Orgs from the Dev Hub Org

You can view and delete your scratch orgs and their associated requests from the Dev Hub org.

In the Dev Hub org, the ActiveScratchOrg standard object represents the scratch orgs that are currently in use. The ScratchOrgInfo standard object represents the requests that were used to create scratch orgs and provides historical context.

  1. Log in to the Dev Hub org as the System Administrator or as a user with the Salesforce DX permissions.
  2. From the App Launcher, select Active Scratch Orgs to see a list of all active scratch orgs.

    To view more details about a scratch org, click the link in the Number column.

  3. To delete an active scratch org from the Active Scratch Orgs list view, choose Delete from the dropdown.

    Deleting an active scratch org doesn’t delete the request (ScratchOrgInfo) that created it, but it does free up a scratch org so that it doesn’t count against your allocations.

  4. To view the requests that created the scratch orgs, select Scratch Org Infos from the App Launcher.

    To view more details about a request, click the link in the Number column. The details of a scratch org request include whether it's active, expired, or deleted.

  5. To delete the request that was used to create a scratch org, choose Delete from the dropdown.

    Deleting the request (ScratchOrgInfo) also deletes the active scratch org.