manifest.json
This article describes manifest.json for web extensions. If you are looking for information about the manifest.json in PWAs, check out the Web App Manifest article.
The manifest.json
file is the only file that every extension using WebExtension APIs must contain.
Using manifest.json
, you specify basic metadata about your extension such as the name and version, and can also specify aspects of your extension's functionality (such as background scripts, content scripts, and browser actions).
It is a JSON-formatted file, with one exception: it is allowed to contain "//
"-style comments.
List of manifest.json keys
manifest.json
keys are listed below:
- author
- background
- browser_action
- browser_specific_settings
- chrome_settings_overrides
- chrome_url_overrides
- commands
- content_scripts
- content_security_policy
- default_locale
- description
- developer
- devtools_page
- dictionaries
- externally_connectable
- homepage_url
- icons
- incognito
- manifest_version
- name
- offline_enabled
- omnibox
- optional_permissions
- options_page
- options_ui
- page_action
- permissions
- protocol_handlers
- short_name
- sidebar_action
- storage
- theme
- theme_experiment
- user_scripts
- version
- version_name
- web_accessible_resources
Notes about manifest.json keys
"manifest_version"
,"version"
, and"name"
are the only mandatory keys."default_locale"
must be present if the "_locales
" directory is present, and must be absent otherwise."browser_specific_settings"
is not supported in Google Chrome.
Accessing manifest.json keys at runtime
You can access your extension's manifest from the extension's JavaScript using the runtime.getManifest()
function:
browser.runtime.getManifest().version;
Example
The block below shows the basic syntax for some common manifest keys.
Note: This is not intended to be used as a copy-paste-ready example. Selecting the keys you'll need depends on the extension you are developing.
For complete example extensions, see Example extensions.
{
"browser_specific_settings": {
"gecko": {
"id": "addon@example.com",
"strict_min_version": "42.0"
}
},
"background": {
"scripts": ["jquery.js", "my-background.js"],
},
"browser_action": {
"default_icon": {
"19": "button/geo-19.png",
"38": "button/geo-38.png"
},
"default_title": "Whereami?",
"default_popup": "popup/geo.html"
},
"commands": {
"toggle-feature": {
"suggested_key": {
"default": "Ctrl+Shift+Y",
"linux": "Ctrl+Shift+U"
},
"description": "Send a 'toggle-feature' event"
}
},
"content_security_policy": "script-src 'self' https://example.com; object-src 'self'",
"content_scripts": [
{
"exclude_matches": ["*://developer.mozilla.org/*"],
"matches": ["*://*.mozilla.org/*"],
"js": ["borderify.js"]
}
],
"default_locale": "en",
"description": "...",
"icons": {
"48": "icon.png",
"96": "icon@2x.png"
},
"manifest_version": 2,
"name": "...",
"page_action": {
"default_icon": {
"19": "button/geo-19.png",
"38": "button/geo-38.png"
},
"default_title": "Whereami?",
"default_popup": "popup/geo.html"
},
"permissions": ["webNavigation"],
"version": "0.1",
"user_scripts": {
"api_script": "apiscript.js",
},
"web_accessible_resources": ["images/my-image.png"]
}
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
author | ChromeFull supportYes | EdgeFull support14
| FirefoxFull support52 | OperaFull supportYes | SafariFull support14
| Firefox for AndroidFull support52 |
background | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
background.page | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
background.persistent | ChromeFull supportYes | EdgeFull support14
| FirefoxPartial support48
| OperaFull supportYes | SafariFull support14
| Firefox for AndroidPartial support48
|
background.scripts | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48
| OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48
|
browser_action | ChromeFull supportYes
| EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes
| SafariFull support14
| Firefox for AndroidFull support55 |
browser_action.browser_style | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support48 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
browser_action.default_area | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
browser_action.default_icon | ChromeFull supportYes
| EdgePartial support14
| FirefoxFull support48 | OperaFull supportYes
| SafariFull support14
| Firefox for AndroidNo supportNo |
browser_action.default_popup | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support57 |
browser_action.default_title | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55
|
browser_action.theme_icons | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support56 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
browser_specific_settings | ChromeNo supportNo | EdgeNo support15 — 79 | FirefoxFull support48
| OperaNo supportNo | SafariPartial support14
| Firefox for AndroidFull support48
|
chrome_settings_overrides | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_settings_overrides.homepage | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_settings_overrides.search_provider | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.alternate_urls | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.encoding | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support65 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.favicon_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.image_url | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.image_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.instant_url | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.instant_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.is_default | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.keyword | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.name | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.prepopulated_id | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.search_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.search_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.suggest_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.suggest_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_settings_overrides.startup_pages | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_url_overrides | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support54 | OperaNo supportNo | SafariFull support14.1 | Firefox for AndroidNo supportNo |
chrome_url_overrides.bookmarks | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_url_overrides.history | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
chrome_url_overrides.newtab | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support54
| OperaNo supportNo | SafariFull support14.1
| Firefox for AndroidNo supportNo |
commands | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14
| Firefox for AndroidNo supportNo |
commands.F1-F12 | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support53 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidNo supportNo |
commands.MediaNextTrack | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
commands.MediaPlayPause | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
commands.MediaPrevTrack | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
commands.MediaStop | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
Secondary modifier other than Shift | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariFull support14 | Firefox for AndroidNo supportNo |
commands.global | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
commands._execute_sidebar_action | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
content_scripts | ChromeFull supportYes
| EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes
| SafariFull support14
| Firefox for AndroidFull support48 |
content_scripts.all_frames | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
content_scripts.css | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
content_scripts.exclude_globs | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
content_scripts.exclude_matches | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
content_scripts.include_globs | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
content_scripts.js | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
content_scripts.match_about_blank | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support52
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support52
|
content_scripts.matches | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
content_scripts.run_at | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14
| Firefox for AndroidFull support48 |
content_security_policy | ChromeFull supportYes | EdgeFull support14
| FirefoxFull support48
| OperaFull supportYes | SafariFull support14 | Firefox for AndroidNo supportNo |
content_security_policy.content_scripts | ChromeNo supportNo
| EdgeNo supportNo
| FirefoxFull support72
| OperaNo supportNo
| SafariNo supportNo | Firefox for AndroidNo supportNo |
content_security_policy.extension_pages | ChromeNo supportNo
| EdgeNo supportNo
| FirefoxFull support72
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
default_locale | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
description | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
developer | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support52 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support52 |
devtools_page | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support54 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
externally_connectable | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
homepage_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14
| Firefox for AndroidFull support48 |
icons | ChromeFull supportYes
| EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14
| Firefox for AndroidFull support48 |
incognito | ChromeFull supportYes | EdgeFull support18 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
incognito.not_allowed | ChromeFull supportYes | EdgeFull support17 | FirefoxFull support67 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support67 |
incognito.spanning | ChromeFull supportYes | EdgeFull support18 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
incognito.split | ChromeFull supportYes | EdgeFull support17 | FirefoxNo supportNo
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo
|
manifest_version | ChromeFull support4 | EdgeFull support14 | FirefoxFull support48 | OperaFull support15 | SafariFull support14 | Firefox for AndroidFull support48 |
Version 1 | ChromeNo support4 — 21 | EdgeNo supportNo | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
Version 2 | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
Version 3 | ChromeFull support88 | EdgeNo supportNo | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
name | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
offline_enabled | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
omnibox | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support52 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
omnibox.key | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support52 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
optional_permissions | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
activeTab | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55 | OperaNo supportNo | SafariFull support14 | Firefox for AndroidFull support55 |
background | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
bookmarks | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
browserSettings | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support57 |
browsingData | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support77 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
clipboardRead | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
clipboardWrite | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
contentSettings | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
contextMenus | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariFull support14 | Firefox for AndroidNo supportNo |
cookies | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
debugger | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
downloads | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support60 |
downloads.open | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support60 |
find | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
geolocation | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support55 |
history | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
idle | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
management | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support77 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
notifications | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
pageCapture | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
pkcs11 | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support77 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
privacy | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support75 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
proxy | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support77 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
sessions | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support77 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
tabHide | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
tabs | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
topSites | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
webNavigation | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
webRequest | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support55 |
webRequestBlocking | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
options_page | ChromeFull supportYes | EdgeFull support14 | FirefoxNo supportNo | OperaFull support15 | SafariFull support14 | Firefox for AndroidNo supportNo |
options_ui | ChromeFull support40 | EdgeFull support79 | FirefoxFull support48 | OperaFull support27 | SafariFull support14 | Firefox for AndroidFull support57 |
options_ui.browser_style | ChromeFull support40
| EdgeFull support79
| FirefoxFull support55 | OperaFull support27
| SafariNo supportNo | Firefox for AndroidFull support57 |
options_ui.open_in_tab | ChromeFull support40 | EdgeFull support79 | FirefoxFull support48 | OperaNo supportNo
| SafariNo supportNo
| Firefox for AndroidFull support57 |
options_ui.page | ChromeFull support40 | EdgeFull support79 | FirefoxFull support48 | OperaFull support27 | SafariFull support14 | Firefox for AndroidFull support57 |
page_action | ChromeFull supportYes
| EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes
| SafariFull support14
| Firefox for AndroidFull supportYes |
page_action.browser_style | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support48 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
page_action.default_icon | ChromeFull supportYes
| EdgePartial support14
| FirefoxFull support48 | OperaFull supportYes
| SafariFull support14
| Firefox for AndroidFull supportYes |
page_action.default_popup | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull supportYes |
page_action.default_title | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull supportYes |
page_action.hide_matches | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
page_action.pinned | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
page_action.show_matches | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support79 |
permissions | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
activeTab | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
alarms | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
background | ChromeFull support10 | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
bookmarks | ChromeFull supportYes | EdgeFull support15 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
browserSettings | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support56 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support56 |
browsingData | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support53 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo support56 — 79 |
captivePortal | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support68 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
clipboardRead | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support54 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support54 |
clipboardWrite | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support51 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support51 |
contentSettings | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
contextMenus | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support55
| OperaFull supportYes | SafariFull support14
| Firefox for AndroidNo supportNo |
contextualIdentities | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support53 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support53 |
cookies | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
debugger | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
dns | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support60 |
downloads | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
downloads.open | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
find | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
geolocation | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support54 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support54 |
history | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support49 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
identity | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support53 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
idle | ChromeFull supportYes | EdgeFull support15 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
management | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support51 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support51 |
menus | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support53 | OperaNo supportNo | SafariFull support14 | Firefox for AndroidNo supportNo |
nativeMessaging | ChromeFull support29 | EdgeFull support15 | FirefoxFull support50 | OperaFull support16 | SafariFull support14 | Firefox for AndroidNo supportNo |
notifications | ChromeFull support5 | EdgeFull support79 | FirefoxFull support48 | OperaFull support25 | SafariNo supportNo | Firefox for AndroidFull support48 |
pageCapture | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
pkcs11 | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support58 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
privacy | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support54 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support54 |
proxy | ChromeFull support33 | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support55 |
search | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
sessions | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support52 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
storage | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
tabHide | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
tabs | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support54 |
theme | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
topSites | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support52 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support52 |
unlimitedStorage | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support56 | OperaNo supportNo | SafariFull support14
| Firefox for AndroidFull support56 |
webNavigation | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull support17 | SafariFull support14 | Firefox for AndroidFull support48 |
webRequest | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
webRequestBlocking | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
protocol_handlers | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support54 |
protocol_handlers.dat | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
protocol_handlers.dweb | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
protocol_handlers.ftp | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support88 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support88 |
protocol_handlers.gopher | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support56 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support56 |
protocol_handlers.ipfs | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
protocol_handlers.ipns | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
protocol_handlers.ssb | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support59 |
short_name | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
sidebar_action | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaFull support30 | SafariNo supportNo | Firefox for AndroidNo supportNo |
sidebar_action.browser_style | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
sidebar_action.default_icon | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaFull support30
| SafariNo supportNo | Firefox for AndroidNo supportNo |
sidebar_action.default_panel | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaFull support30 | SafariNo supportNo | Firefox for AndroidNo supportNo |
sidebar_action.default_title | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support54 | OperaFull support30 | SafariNo supportNo | Firefox for AndroidNo supportNo |
sidebar_action.open_at_install | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support62 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
storage | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariFull support14 | Firefox for AndroidNo supportNo |
storage.managed_schema | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariFull support14 | Firefox for AndroidNo supportNo |
theme | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull supportYes |
theme.colors | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support65 |
colors.accentcolor | ChromeNo supportNo | EdgeNo supportNo | FirefoxNo support55 — 70
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support65 |
colors.bookmark_text | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support58
| OperaNo supportNo | SafariNo supportNo
| Firefox for AndroidNo supportNo |
colors.button_background_active | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.button_background_hover | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.frame | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support55
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull supportYes |
colors.frame_inactive | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.frame_incognito | ChromeFull supportYes
| EdgeFull support79
| FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.frame_incognito_inactive | ChromeFull supportYes
| EdgeFull support79
| FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.icons | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.icons_attention | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.ntp_background | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.ntp_header | ChromeFull supportYes
| EdgeFull support79
| FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.ntp_link | ChromeFull supportYes
| EdgeFull support79
| FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.ntp_text | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.popup | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.popup_highlight | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.popup_highlight_text | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.popup_text | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_background_separator | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support62 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_background_text | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support59 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_line | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_loading | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_selected | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support60 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.tab_text | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support55
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.textcolor | ChromeNo supportNo | EdgeNo supportNo | FirefoxNo support55 — 70
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar | ChromeFull supportYes
| EdgeFull support79
| FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_bottom_separator | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support58
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_border | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_border_focus | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_focus | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_highlight | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support67 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_highlight_text | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support67 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_separator | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support59
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_text | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_field_text_focus | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support61 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_text | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_top_separator | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support58
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
colors.toolbar_vertical_separator | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support58
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
theme.images | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull supportYes |
images.additional_backgrounds | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
images.headerURL | ChromeNo supportNo | EdgeNo supportNo | FirefoxNo support55 — 70
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
images.theme_frame | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull supportYes
|
theme.properties | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
theme_experiment | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
theme_experiment.colors | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
theme_experiment.images | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
theme_experiment.properties | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
user_scripts | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support68 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support68 |
user_scripts.api_script | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support68 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support68 |
version | ChromeFull supportYes
| EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
version_name | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariFull support14 | Firefox for AndroidNo supportNo |
web_accessible_resources | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support48 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
Legend
- Full support
- Full support
- Partial support
- Partial support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Non-standard. Check cross-browser support before using.
- Deprecated. Not for use in new websites.
- See implementation notes.
- User must explicitly enable this feature.
- Uses a non-standard name.
For a full overview of all manifest keys and their sub-keys, see the full manifest.json
browser compatibility table.
See also
permissions
JavaScript API