Blog

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 we retire functionality in the AddressTools package, you are required to follow an upgrade path to work your way to the latest version.

Step 1: Identify the version of AddressTools currently installed

When in Salesforce, locate the current version of AddressTools you have installed.

  • Go to Salesforce Setup.
  • Navigate to Installed Packages.
  • Make note of the version number next to AddressTools Premium.
Step 2: Check the AddressTools release notes

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

Step 3: Locate “Bridge” packages in the release notes between current installed and latest version

After finding the version you currently have installed, read through the release notes until you reach the latest version.

When reviewing each release, identify any “Bridge” packages. These will have a Sandbox and Production install link available (shown in screenshot below).


Step 4: Sequentially install the Bridge packages

When you first encounter a “Bridge” package, use the links provided in the release notes to upgrade to that version.

Wait for the installation to be successful and then if there are more “Bridge” packages, repeat this step for each “Bridge” package until there are no more in the release notes.

Step 5: Update to the latest version available on the AppExchange

Once the latest “Bridge” package is installed in your organization, immediately update to the latest version available via the Salesforce AppExchange.

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 AppExchange listing.

Step 6: Done!

Good news! You’ve now successfully upgraded to the latest version of AddressTools and can enjoy all the latest functionality. If you have any issues following the steps above, reach out to support@provenworks.com noting how far you have got on your road to upgrading AddressTools and a member of the team will get back to you.

Leave a Reply