Salesforce DX Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
How Salesforce Developer Experience (DX) Tooling Changes the Way You Work
Provide Developers Access to Salesforce DX Tools
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Track Changes Between Your Project and Org
Work with Data
Development
Build and Release Your App
Unlocked Packages
What’s an Unlocked Package?
Package-Based Development Model
Before You Create Unlocked Packages
Know Your Orgs
Create Org-Dependent Unlocked Packages
Workflow for Unlocked Packages
Configure Unlocked Packages
How We Handle Profile Settings in Unlocked Packages
Develop Unlocked Packages
Push a Package Upgrade for Unlocked Packages
Schedule a Push Upgrade Using CLI
Install an Unlocked Package
Migrate Deprecated Metadata from Unlocked Packages
Uninstall an Unlocked Package
Transfer an Unlocked Package to a Different Dev Hub
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Push a Package Upgrade for Unlocked Packages

Push upgrades enable you to upgrade packages installed in orgs, without asking org admins to install the upgrade themselves. You can choose which orgs receive a push upgrade, what version the package is upgraded to, and when you want the upgrade to occur. Push upgrades are particularly helpful if you need to push a change for a hot bug fix.

Use Salesforce CLI or SOAP API to initiate the push upgrade, track the status of each job, and review error messages if any push upgrades fail.

The CLI push upgrade commands are available to second-generation managed packages and unlocked packages. For unlocked packages, push upgrades are enabled by default.

Table 1. Package Types and Push Upgrade Options
Package Type Push Upgrade using CLI? Push Upgrade using API? Push Upgrade using UI?
2GP Yes Yes No
1GP No Yes Yes
Unlocked Yes Yes No

Push Upgrade Considerations for Unlocked Packages

  • You can include new and changed features, or remove features during a push upgrade.
  • When a push upgrade is installed, the Apex in the package is compiled.
  • You can use push upgrades even if the package version requires a password.