Disabling and enabling add-ons

You can enable or disable Atlassian application add-ons 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.

Disabling paid add-ons in cloud instances

If you disable a paid add-on in a cloud instance, UPM automatically reactivates the add-on within a month. We designed UPM so that if you paid for an add-on, you can use it.

If you want to both disable and 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 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 Oct 6, 2015

Was this helpful?

Yes
No
Provide feedback about this article

Not finding the help you need?

Ask the community

Powered by Confluence and Scroll Viewport.