browserSettings.zoomSiteSpecific

A BrowserSetting object whose underlying value is a boolean.

This property sets the configuration setting browser.zoom.siteSpecific, which controls how zoom settings are applied to sites and tabs.

If browser.zoom.siteSpecific is true, zoom operations apply to all pages from the same site so that:

  • when a page loads, if there is a zoom level for that site it is applied to the page otherwise the global default zoom level is applied.
  • when the zoom level for a page changes, the zoom levels of other pages from the site in other tabs are also changed.

If browser.zoom.siteSpecific is set false, zoom operations apply to the active tab only so that:

  • when a new tab opens, the global default zoom level is applied.
  • when the zoom level in a tab changes, it persists across page loads and does not affect the zoom level in any other tab.

When Firefox is installed, browser.zoom.siteSpecific is true.

If privacy.websites.resistFingerprinting is true, this setting has no effect and zoom is set on a per-tab basis.

Examples

Set the setting to false:

js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.zoomSiteSpecific.set({ value: false }).then(logResult);

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
zoomSiteSpecific
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 75 (Release date: 2020-04-07)
footnote Full support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 79 (Release date: 2020-07-28)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support