Recommend a Package Version to Your Subscribers

You can now encourage your subscribers to upgrade to a specific version of a package by setting a recommended version. When you set a package version as the recommended version, your subscribers see an Upgrade to Recommended Version option on the Installed Packages page in their org. Only released package versions can be the recommended version.

Where: This change applies to second-generation managed packaging.

How: Promote a package version to the released state. Run the sf package update CLI command and specify the version in the --recommended-version-id flag. If a subscriber has a package version installed in their org that’s lower than the version you set for the --recommended-version-id flag, the subscriber sees the Upgrade to Recommended Version option on the Installed Packages page.

The Upgrade to Recommended Version link on a subscriber's Installed Packages page.