Skip to content

AddressTools: This App Can't Be Upgraded

Why Am I Getting This Error?

There are a number of reasons why this error can be shown, but most commonly it is linked with upgrading the package to the latest version where some of its functionality may have been retired.

If the error mentions the new package version removes some of its components, see the steps below on how to successfully upgrade.

How to Resolve

When functionality is retired in the AddressTools package, an upgrade path must be followed to work through to the latest version.

Step 1: Identify the Version of AddressTools Currently Installed

  1. Go to Salesforce Setup.
  2. Navigate to Installed Packages.
  3. Note the version number next to AddressTools Premium.

Step 2: Check the AddressTools Release Notes

Navigate to the AddressTools release notes on the ProvenWorks website and find the version currently installed in Salesforce.

Step 3: Locate "Bridge" Packages in the Release Notes Between the Current Installed and Latest Version

After finding the currently installed version, read through the release notes until reaching the latest version.

When reviewing each release, identify any "Bridge" packages. These have a Sandbox and Production install link available.

Step 4: Sequentially Install the Bridge Packages

When first encountering a "Bridge" package, use the links provided in the release notes to upgrade to that version.

Wait for the installation to succeed, then if there are more "Bridge" packages, repeat this step for each one until there are no more in the release notes.

Step 5: Update to the Latest Version Available on AgentExchange

Once the latest "Bridge" package is installed, immediately update to the latest version available via the AgentExchange (formerly AppExchange) listing.

Note: Bridge versions are designed to remove upgrade barriers and are not considered stable. It is important to upgrade to the latest version available via the AgentExchange listing.

Step 6: Done

Once complete, the org is upgraded to the latest version of AddressTools with all the latest functionality. If issues occur following the steps above, contact support@provenworks.com, noting how far the upgrade got, and a member of the team will follow up.