Add-ons

storage.managed

A storage.StorageArea object that represents the managed storage area. Items in managed storage are set by the domain administrator or other native applications installed on user's computer, and are read-only for the extension. Trying to modify this storage area results in an error.

Provisioning managed storage

The procedure for provisioning managed storage is different for different browsers. For Chrome instructions, see the "Manifest for storage areas" article.

For Firefox, you need to create a JSON manifest file in a specific format, in a specific location. For the details of manifest syntax and location, see Native manifests.

Here's an example manifest:

{
  "name": "favourite-colour-examples@mozilla.org",
  "description": "ignored",
  "type": "storage",
  "data":
  {
    "colour": "management thinks it should be blue!"
  }
}

Given this manifest, the "favourite-colour-examples@mozilla.org" extension could access the data using code like this:

var storageItem = browser.storage.managed.get('colour');
storageItem.then((res) => {
  console.log(`Managed colour is: ${res.colour}`);
});

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic support Yes No571 2 3 No No

1. Platform-specific storage backends, such as Windows registry keys, are not supported.

2. Enforcement of extension-provided storage schemas is not supported.

3. The onChanged event is not supported.

Example extensions

Acknowledgements

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

Document Tags and Contributors

 Contributors to this page: wbamberg, zombie, chrisdavidmills
 Last updated by: wbamberg,