Disabling and enabling add-ons

You can enable or disable Atlassian application add-ons for Atlassian Server applications from the Manage add-ons page. Disabling an add-on makes its features unavailable in the application, but it doesn't actually remove the add-on. Disabling add-ons is sometimes useful for troubleshooting application problems, and disabled add-ons can always be re-enabled later.

Add-ons that are essential for system operation can't be disabled.

If you want to remove an add-on from your application instance completely, uninstall the add-on.

You can disable user-installed add-ons individually or all at once. To disable all user-installed add-ons, use Safe mode.

On this page:

Disabling an add-on

To disable a user-installed add-on in your application:

  1. As a user with administrative privileges, click the Manage add-ons link in the administration menu. 
  2. Find the add-on you want to disable in the installed add-on list by searching or browsing to the add-on.
  3. Click Disable.
    Many system add-ons are integral to the operation of the system and do not have a Disable button.
  4. If prompted, restart your application to have your change take effect.
    Once the add-on is disabled, its features are immediately unavailable in the application. If existing artifacts use the add-on, you may see an error message. For example, if you disable the team calendar add-on in Confluence, existing pages that use the calendar will display an 'unknown macro' error.

Unsubscribing and uninstalling paid add-ons in cloud instances

Add-ons cannot be disabled in Atlassian Cloud applications. To stop using an add-on, you must either unsubscribe or uninstall the add-on.

If you want to unsubscribe, you can do this from the Manage add-ons screen. Just click Unsubscribe. This effectively cancels your subscription to the add-on.


Enabling an add-on

To enable a user-installed add-on in your application:

  1. As a user with administrative privileges, click the Manage add-ons link in the administration menu.
  2. Find the add-on you want to enable in the installed add-on list by searching or browsing to the add-on.
  3. Click the Enable button.

Disabling or enabling all add-ons (using Safe Mode)

Running your Atlassian Server application in Safe Mode disables all user installed add-ons at once. All add-ons that were disabled when you entered Safe Mode will be re-enabled when you exit Safe Mode.

To enable safe mode: 

  1. Click the Enable safe mode link at the bottom of the page.
    The 'Do you wish to continue?' dialog box appears.
  2. Click the Continue button to confirm the operation.
    All user-installed add-ons are disabled and your application now runs in safe mode, as indicated by the message on the page.

You can now individually enable or uninstall add-ons.

When finished, exit safe mode by clicking one of these links in the Safe Mode banner:

  • Exit Safe Mode and restore the previous configuration enables user-installed add-ons, restoring your add-on configuration to the state before you entered Safe Mode.
  • Exit Safe Mode and keep the current configuration enables user-installed add-ons, keeping all changes made to your add-on configuration while in Safe Mode.


Last modified on Feb 26, 2018

Was this helpful?

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