Uninstalling add-ons

You can remove an installed add-on from your application in the add-on administration pages. Uninstalling an add-on permanently removes it from your application and file system. If you only want to temporarily remove it from an Atlassian Server application, you may choose to disable your add-on instead.

On this page:

Uninstalling an add-on

Uninstalling an add-on removes the add-on from the application. It also removes the JAR file from the application's home directory.

To uninstall an add-on:

  1. From the application's administration console, click the Manage add-ons link. 
  2. Find the add-on you want to uninstall in the add-on list.
  3. Click on the add-on to open its details view.
  4. Click the Uninstall button.
  5. Confirm the action by clicking Continue.
    When finished, a notice appears in the add-on details view indicating that the add-on was successfully uninstalled.
  6. You can click on the grayed out add-on banner to resume working in the 'Manage Add-ons' page.

Uninstalling an add-on by removing its JAR file

In rare cases, you may need to uninstall an add-on manually, by removing its JAR file from the installation directory. This may be necessary, for example, when troubleshooting issues that may be related to the add-on.

These instructions do not apply to Confluence. For information on removing add-ons in Confluence, see How to manually remove malfunctioning add-ons.

You can uninstall an add-on manually by removing its JAR file from the file system. The directory location from where you remove the JAR file varies by Atlassian application. The following instructions use JIRA as an example. For information on removing add-ons from other applications, see the documentation for the host application.

  1. Shut down the application instance.
  2. Remove the JAR file from the add-on directory applicable to your host application. For example, in JIRA:
    • If you are removing a version 1 add-on, remove the JAR from your JIRA installation directory under:
    • If you are removing a version 2 add-on, remove the JAR from your JIRA home directory under:
  3. Start the application instance again.
  4. Go to the Manage Add-ons page to confirm that the add-on no longer appears in the list.

Last modified on Feb 26, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.