1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. tabs
  6. tabs.ZoomSettingsScope

tabs.ZoomSettingsScope

Defines whether zoom changes will persist for the page's origin, or only take effect in this tab. This defaults to per-origin when tabs.zoomSettingsMode is "automatic", and is always per-tab otherwise.

Type

Values of this type are strings. Possible values are:

"per-origin"

All other tabs with the same origin as this tab will have the zoom changes applied to them. This scope is only available if tabs.zoomSettingsMode is "automatic".

"per-tab"

Zoom changes only take effect in this tab, and zoom changes in other tabs will not affect the zooming of this tab. Also:

  • in Firefox the zoom level persists across page loads and navigation within the tab.
  • in Chrome-based browsers zoom changes are reset on navigation; navigating a tab will always load pages with their per-origin zoom factors.

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
ZoomSettingsScope
Chrome – Full support
Chrome 38 (Release date: 2014-10-07)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 45 (Release date: 2016-03-08)
footnote Full support
Opera – Full support
Opera 25 (Release date: 2014-10-15)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android
footnote No support
Safari on iOS – No support
Safari on iOS
footnote No support

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

Full support
No support

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

This page was last modified on by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.