Skip to content
Suggest a correction

Choose a package version

Getting started3 min read

Find the current Record Health Check release, install an exact package version, and plan how to recover if a version must be reversed. Record Health Check is distributed as a Salesforce unlocked package with the namespace rhc.

This documentation describes version 2.0.11, the current release.

ReleaseVersion numberPackage version ID
Current2.0.11.404tak000000nGjZAAU
Previous2.0.10.104tak000000h2wDAAQ

Record Health Check is a second-generation unlocked package. Each released version has a version number, such as 2.0.11.4, and a package version ID that begins with 04t. Salesforce never changes a released version, so a given ID always installs the same contents.

The public installation links always open the latest released version:

Org typeInstallation link
SandboxInstall in Sandbox
Production or Developer EditionInstall in Production

Both links install the same version. They differ only in the Salesforce login domain they open.

The release registry in the Record Health Check repository records the current version and its 04t ID under stable, and the previous release under previous. The release notes describe what each version changed.

  1. In Setup, enter Installed Packages in Quick Find, then select Installed Packages.
  2. Find Record Health Check and read Version Number.

Use an exact version ID when you install the same version in several orgs, such as a sandbox and then production, and need to be certain that each org receives identical contents.

  1. Copy the 04t ID of the version you want from the table at the top of this page, or from the release registry, where the current release is stable.subscriberPackageVersionId.

  2. Install it with the Salesforce CLI, replacing PACKAGE_VERSION_ID and ORG_ALIAS:

    Terminal window
    sf org display --target-org ORG_ALIAS
    sf package install --package PACKAGE_VERSION_ID --target-org ORG_ALIAS --security-type AdminsOnly --wait 30 --publish-wait 10 --no-prompt

    To install in a browser instead, open https://test.salesforce.com/packaging/installPackage.apexp?p0=PACKAGE_VERSION_ID for a sandbox, or the same path on https://login.salesforce.com for production, with your ID in place of PACKAGE_VERSION_ID.

  3. Confirm the target org and version on the Salesforce installation page before you select Install.

If Record Health Check is already installed, follow Upgrade an installation instead. It includes the configuration backup and checks that an upgrade requires.

After installation, assign Permission Sets and add the card to a page as described in Install Record Health Check in a sandbox.

You cannot rely on installing a lower version over a higher one. Salesforce package upgrade rules do not support downgrading an unlocked package in place. Test every version change in a sandbox that represents production before you install it in production.

SituationRecovery path
A new org needs a specific versionInstall that version’s 04t ID.
An upgrade failed testing and has not reached productionStop the rollout. Production stays on its current version.
An installed upgrade causes a problemKeep your Check Sets and Checks, and install a later corrective version after it passes sandbox testing.
The package must be removedFollow Uninstall Record Health Check. To return to an earlier version, reinstall that version afterward and restore your configuration from a backup.

Back up the Check Sets and Checks your organization created, and record which Lightning pages use them, before any upgrade or uninstall. See Back up and restore configuration.