management

Get information about installed add-ons.

With the management API you can:

  • get information about installed add-ons
  • enable/disable add-ons
  • uninstall add-ons
  • find out which permission warnings are given for particular add-ons or manifests
  • get notifications of add-ons being installed, uninstalled, enabled, or disabled.

Most of these operations require the "management" API permission. Operations that don't provide access to other add-ons don't require this permission.

Types

management.ExtensionInfo
An object that contains information about an installed add-on.

Functions

management.getAll()
Returns information about all installed add-ons.
management.get()
Returns information about a particular add-on, given its ID.
management.getSelf()
Returns information about the calling add-on.
management.install()
Installs a particular theme, given its URL at addons.mozilla.org.
management.uninstall()
Uninstalls a particular add-on, given its ID.
management.uninstallSelf()
Uninstalls the calling add-on.
management.getPermissionWarningsById()
Get the set of permission warnings for a particular add-on, given its ID.
management.getPermissionWarningsByManifest()
Get the set of permission warnings that would be displayed for the given manifest string.
management.setEnabled()
Enable/disable a particular add-on, given its ID.

Events

management.onInstalled
Fired when an add-on is installed.
management.onUninstalled
Fired when an add-on is uninstalled.
management.onEnabled
Fired when an add-on is enabled.
management.onDisabled
Fired when an add-on is disabled.

Browser compatibility

Report problems with this compatibility data on GitHub
webextensions-desktopwebextensions-mobile
ChromeEdgeFirefoxOperaSafariFirefox for Android
ExtensionInfo
ExtensionInfo.disabledReason
ExtensionInfo.offlineEnabled
ExtensionInfo.type
ExtensionInfo.versionName
get
getAll
getPermissionWarningsById
getPermissionWarningsByManifest
getSelf
install
onDisabled
onEnabled
onInstalled
onUninstalled
setEnabled
uninstall
uninstallSelf
uninstallSelf.dialogMessage

Legend

Full support
Full support
No support
No support
See implementation notes.

Example extensions

Acknowledgements

This API is based on Chromium's chrome.management API. This documentation is derived from management.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.