MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Add-ons

web_accessible_resources

Type Array
Mandatory No
Example
"web_accessible_resources": [
  "images/my-image.png"
]

Sometimes you will want to package some resources - for example, images, HTML, CSS, or JavaScript - with your extension, and make them available to web pages.

For example, the "beastify" example extension used in the walkthrough tutorial replaces images in a web page with images of some beasts, by setting the src attribute of any <img> elements. The images are packaged with the extension, and for the web page to be able to load them, they must be made web accessible.

The web_accessible_resources key lists all packaged resources that you want to make available to web pages in this way. You specify them as paths relative to the manifest.json file.

The files will then be available using a URL like: "moz-extension://<random-UUID>/<path/to/resource>".

This UUID is randomly generated for every browser instance and is not your extension's ID. This prevents websites from fingerprinting the extensions a user has installed.

For example, consider an entry like this:

  "web_accessible_resources": ["images/my-image.png"]

If the random UUID is 944cfddf-7a95-3c47-bd9a-663b3ce8d699, then this resource will be available at the following URL:

moz-extension://944cfddf-7a95-3c47-bd9a-663b3ce8d699/images/my-image.png

Entries can contain wildcards, for example:

  "web_accessible_resources": ["images/*.png"]

Will also work.

The easiest way to get this URL is to use the browser.extension.getURL API, and give it the path relative to manifest.json:

browser.extension.getURL("images/my-image.png");

Note that content scripts don't need to be listed as web accessible resources.

Example

"web_accessible_resources": ["images/my-image.png"]

Make the file at "images/my-image.png" web accessible.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesYes4848Yes

Document Tags and Contributors

 Contributors to this page: John-Nagle, wbamberg, evilpie, mwein, Makyen, andymckay-github
 Last updated by: John-Nagle,