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
Sandboxes
Track Changes Between Your Project and Org
Development
Build and Release Your App
First-Generation Managed Packages
Second-Generation Managed Packages
Unlocked Packages
What’s a Package
Package-Based Development Model
Before You Create Unlocked Packages
Know Your Orgs
Create Org-Dependent Unlocked Packages
Workflow for Unlocked Packages
Configure Packages
Create a Package
Generate the Package
Generate a Package Version
Code Coverage for Unlocked Packages
Release an Unlocked Package
Update a Package Version
Delete a Package or Package Version
View Package Details
Push a Package Upgrade
Install a Package
Migrate Deprecated Metadata from Unlocked Packages
Uninstall a Package
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Delete a Package or Package Version

Use the force:package:version:delete and force:package:delete commands to delete packages and package versions that you no longer need.

To delete a package or package version, users need the Delete Second-Generation Packages user permission. Before you delete a package, first delete all associated package versions.

Package Type Can I delete beta packages and package versions? Can I delete released packages and package versions?
Second-Generation Managed Packages Yes No
Unlocked Packages Yes Yes

Considerations for Deleting a Package or Package Version

  • Deletion is permanent.
  • Attempts to install a deleted package version will fail.
  • Before deleting, ensure that the package or package version isn’t referenced as a dependency.

Examples:

1$ sfdx force:package:delete -p "Your Package Alias"
1$ sfdx force:package:delete -p 0Ho...
1$ sfdx force:package:version:delete -p "Your Package Version Alias"
1$ sfdx force:package:version:delete -p 04t...

These CLI commands can’t be used with first-generation managed packages or package versions. To delete a first-generation managed package, see View Package Details in the ISVforce Guide.