Skip to end of metadata
Go to start of metadata

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:

  1. As an administrator, go to the Find new add-ons or Manage add-ons page from the administration console.
  2. Click (Product name) update check from the bottom of the page. For example, this might be Confluence update check or JIRA update check.
  3. 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:
    Confluence Update check
  4. Click Check.
    You'll see a results page that resembles this: 
    Update check results

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.

CompatibleThese 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.

  • No labels


  1. Did this get moved in Confluence 5.2.3?  I can't find the link to "check compatibility" at the bottom of the Manage Add-ons page, and seems like plenty enough time has passed.  Maybe they revoked 5.2.4 and now it hasn't picked up on 5.2.5 just yet?

  2. You might be able to navigate directly to /confluence/plugins/servlet/upm/check. 5.2.4 was indeed withdrawn, but I'm not aware of issues for other versions accessing this page. If you upgrade and still aren't able to access this section, let us know: 

    • Your current version of Confluence
    • Your version of UPM

    Best of luck! 


  3. This option is no longer available in JIRA 5.0.5. It used to, I have a printed report from June 2014, but now I get a message stating The Atlassian Marketplace is not reachable despite no configuration changes on our side.

    1. Hi Jose Luis Chavez,

      Thanks for reporting this issue. We've resolved a server misconfiguration. You should now be able to reach Atlassian Marketplace from JIRA 5.0.5. However, I also highly encourage you to upgrade to a more recent version of the Universal Plugin Manager (UPM). (smile) 

      1. Great Thank you for your quick response, and yes, this whole report is part of the efforts to upgrade to the newest version of everything.

  4. How to force UPM to clear cached compatibility?


    The vendor updated their marketplace listing with latest version, but UPM continues to say its not compatible.



  5. What is the workaround in case if we found incompatible plug-ins before migration?