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)
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

Manage Scratch Orgs from Dev Hub

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

In Dev Hub, ActiveScratchOrgs represent the scratch orgs that are currently in use. ScratchOrgInfos represent the requests that were used to create scratch orgs and provide historical context.

  1. Log in to Dev Hub org as the System Administrator or as a user with the Salesforce DX permissions.
  2. From the App Launcher, select Active Scratch Org 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 Org list view, choose Delete from the dropdown.

    Deleting an active scratch org does not 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 Info 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.