Skip to content

Permissions

Rob Kodey edited this page Sep 7, 2025 · 3 revisions

Permission changes in v8.0.0.0 ( conversion to Manifest V3)

  • favicon replaces "chrome://favicon/*"

    Message displayed: "Read the icons of the websites you visit."

  • alarms

    • Required to automatically suspend tabs at specified times.
    • Replaces the old technique of using setTimeout, which is not usable in Manifest V3.

    Message displayed: "Read the icons of the websites you visit."

  • tabGroups

    • Required to export/import and save/restore your tabs that are assigned to tab groups.

    Message displayed: "View and manage your tab groups."

  • scripting replaces "content_scripts"

    • Replaces the old content script permissions, and is used for detecting un-submitted form data, scroll position, etc.

    Message displayed: "Read and change all your data on all websites."

  • host_permissions

    • http://*/*, https://*/*
    • Used with "scripting" above to enable the content script for detecting un-submitted form data, scroll position, etc.
Expand to see source
  "permissions": [
    "tabs",
    "storage",
    "history",
    "unlimitedStorage",
-   "chrome://favicon/*",
+   "favicon",
    "contextMenus",
    "cookies",
-   "http://*/*",
-   "https://*/*",
-   "file://*/*"
+   "alarms",
+   "scripting",
+   "tabGroups"
  ],
+ "host_permissions": [
+   "http://*/*",
+   "https://*/*"
+ ],
- "content_scripts": [
-   {
-     "matches": [
-       "http://*/*",
-       "https://*/*",
-       "file://*/*"
-     ],
-     "js": [ "js/contentscript.js" ]
-   }
- ],

Permissions from older versions

  • tabs

    • Required for basic extension functionality.

    Message displayed: "Read your browsing history"

  • history

    • Used to remove the suspended "mini-page" from history during un-suspend.

    Message displayed: "Read and change your browsing history"

  • http://*/*, https://*/*, file://*/*

    • Were used in Manifest V2 to allow the extension to function on all websites for features like preventing suspending a page if there is un-submitted form data.

    Message displayed: "Read and change all your data on the websites you visit"

  • storage and unlimitedStorage

    • Are used for configuration, caching favicons, and saving sessions.
    • Since sessions can become quite large if you have a lot of tabs open, "unlimited" storage is needed to ensure we can save all your tab details.
    • ( "unlimited" is the only option available to extensions. )
  • chrome://favicon/*

    • Was used to grant access to chrome's favicon cache, to display the website favicon on suspended pages.
  • contextMenus

    • Are used to put Marvellous Suspender commands in the browser context menu.
  • cookies

    • Are only used for migrating old versions of the extension, where the page scroll position was stored as a cookie.
  • content_scripts

    • http://*/*, https://*/*, file://*/*
    • The extension's content script is used on all pages to detect un-submitted form data, scroll position, youtube progress, and other attributes needed to control and restore suspended tabs.
Expand to see source
  "permissions": [
    "tabs",
    "storage",
    "history",
    "unlimitedStorage",
    "chrome://favicon/*",
    "contextMenus",
    "cookies",
    "http://*/*",
    "https://*/*",
    "file://*/*"
  ],
  "content_scripts": [
    {
      "matches": [
        "http://*/*",
        "https://*/*",
        "file://*/*"
      ],
      "js": [ "js/contentscript.js" ]
    }
  ],