Enables an extension to modify certain global browser settings. Each property of this API is a BrowserSetting object, providing the ability to modify a particular setting.
Because these are global settings, it's possible for extensions to conflict. See the documentation for BrowserSetting.set() for details of how conflicts are handled.

To use this API you need to have the "browserSettings" permission.


Determines whether code running in web pages can display popups in response to user events.
Determines whether the browser cache is enabled or not.
Determines whether the selected tab can be closed with a double click.
Determines the mouse event that triggers a context menu popup.
Read the value of the browser's home page.
Determines how the browser treats animated images.
Reads the value of the browser's new tab page.
Controls the position of newly opened tabs relative to already open tabs.
Determines whether bookmarks are opened in the current tab or a new tab.
Determines whether search results are opened in the current tab or a new tab.
Determines whether address bar autocomplete suggestions are opened in the current tab or a new tab.
Controls whether the user-chosen colors override the page's colors.
Controls whether the browser will use the fonts specified by a web page or use only built-in fonts.
Prevents websites from showing notifications using the Notification Web API.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
allowPopupsForUserEvents No No5757 No
cacheEnabled No No5656 No
contextMenuShowEvent No No5959 No
homepageOverride No No5757 No
imageAnimationBehavior No No5757 No
newTabPageOverride No No5757 No
newTabPosition No No6161 * No
openBookmarksInNewTabs No No5959 No
openSearchResultsInNewTabs No No5959 No
openUrlbarResultsInNewTabs No No6161 No
overrideDocumentColors No No6161 No
useDocumentFonts No No6161 No
webNotificationsDisabled No No5858 No

Document Tags and Contributors

Contributors to this page: wbamberg, l-hedgehog, Robbendebiene, hellosct1
Last updated by: wbamberg,