When you're planning an update to your Atlassian application, you can check the compatibility of your add-ons with the target application version. This helps you identify potential compatibility issues before you start the update. We recommend carefully testing updates in a staging environment before deploying to production, but using the add-on update check can help save you time and effort during the update itself.
Add-on update check available in online-mode applications
The update check is only available in host applications in online mode that can contact the Atlassian Marketplace site.
Checking add-on compatibility
To check compatibility of your add-ons:
- As an administrator, go to the Find new add-ons or Manage add-ons page from the administration console.
- Click (Product name) update check from the bottom of the page. For example, this might be Confluence update check or JIRA update check.
- In the Check compatibility for update to menu, choose the version you'd like to check against your add-ons.
You'll see a menu showing subsequent versions of your Atlassian applications:
- Click Check.
You'll see a results page that resembles this:
You can click the name of any add-on to view more information for that add-on.
Version compatibility results
After performing the compatibility check, UPM provides results by listing your add-ons into the following categories:
The installed versions of these add-ons are not compatible with your selected application version, and there aren't any available add-on updates available that are compatible with your selected application version.
|Compatible||These currently installed add-on versions are compatible with your selected application version.|
|Compatible, if updated|
Installed versions of these add-ons aren't compatible with your selected application version, but they will be compatible if you update them.
|Compatible once both are updated|
Installed versions of these add-ons aren't compatible with the selected application version, but there's an add-on version that is compatible with the newer application version. The new version of the add-on isn't compatible with your current application, so you'll need to upgrade the application and then the add-on.