Get advanced security protections with Chrome Enterprise Premium. Learn more.

Filters and search
Any Platform
Chrome 133
  • Chrome 134 (Beta)

  • Chrome 133

  • Chrome 132

  • Chrome 131

  • Chrome 130

  • Chrome 129

  • Chrome 128

  • Chrome 127

  • Chrome 126

  • Chrome 125

  • Chrome 124

  • Chrome 123

Class management tools Settings
Content settings
Gaia user identity management settings
Microsoft® Active Directory® management settings
Miscellaneous

ExtensionSettings

Extension management settings

Supported on:

  • Google Chrome (Linux, Mac, Windows) since version 62
  • Google ChromeOS (Google ChromeOS) since version 62
  • Description:

    Setting the policy controls extension management settings for Google Chrome, including any controlled by existing extension-related policies. The policy supersedes any legacy policies that might be set.

    This policy maps an extension ID or an update URL to its specific setting only. A default configuration can be set for the special ID "*", which applies to all extensions without a custom configuration in this policy. With an update URL, configuration applies to extensions with the exact update URL stated in the extension manifest ( http://support.google.com/chrome/a?p=Configure_ExtensionSettings_policy ). If the 'override_update_url' flag is set to true, the extension is installed and updated using the "update" URL specified in the ExtensionInstallForcelist policy or in 'update_url' field in this policy. The flag 'override_update_url' is ignored if the 'update_url' is a Chrome Web Store url.

    On Microsoft® Windows® instances, apps and extensions from outside the Chrome Web Store can only be forced installed if the instance is joined to a Microsoft® Active Directory® domain, joined to Microsoft® Azure® Active Directory® or enrolled in Chrome Enterprise Core.

    On macOS instances, apps and extensions from outside the Chrome Web Store can only be force installed if the instance is managed via MDM, joined to a domain via MCX or enrolled in Chrome Enterprise Core.

    Supported features:

    • Dynamic Policy Refresh : Yes
    • Per Profile : Yes

    This policy is part of the Extensions atomic policy group.

    Data type:

    Dictionary Windows:REG_SZ

    Windows registry location:

    Software\Policies\Google\Chrome\ExtensionSettings
    Copied to clipboard

    Mac/Linux preference name:

    ExtensionSettings
    Copied to clipboard

    Schema:

    {
     "patternProperties": {
      "^[a-p]{32}(?:,[a-p]{32})*,?$": {
       "properties": {
        "allowed_permissions": {
         "id": "ListOfPermissions",
         "items": {
          "pattern": "^[a-z][a-zA-Z0-9.]*$",
          "type": "string"
         },
         "type": "array"
        },
        "blocked_install_message": {
         "description": "text that will be displayed to the user in the chrome webstore if installation is blocked.",
         "type": "string"
        },
        "blocked_permissions": {
         "items": {
          "pattern": "^[a-z][a-zA-Z0-9.]*$",
          "type": "string"
         },
         "type": "array"
        },
        "file_url_navigation_allowed": {
         "type": "boolean"
        },
        "installation_mode": {
         "enum": [
          "blocked",
          "allowed",
          "force_installed",
          "normal_installed",
          "removed"
         ],
         "type": "string"
        },
        "minimum_version_required": {
         "pattern": "^[0-9]+([.][0-9]+)*$",
         "type": "string"
        },
        "override_update_url": {
         "type": "boolean"
        },
        "runtime_allowed_hosts": {
         "id": "ListOfUrlPatterns",
         "items": {
          "type": "string"
         },
         "type": "array"
        },
        "runtime_blocked_hosts": {
         "items": {
          "type": "string"
         },
         "type": "array"
        },
        "toolbar_pin": {
         "enum": [
          "force_pinned",
          "default_unpinned"
         ],
         "type": "string"
        },
        "update_url": {
         "type": "string"
        }
       },
       "type": "object"
      },
      "^update_url:": {
       "properties": {
        "allowed_permissions": {
         "items": {
          "pattern": "^[a-z][a-zA-Z0-9.]*$",
          "type": "string"
         },
         "type": "array"
        },
        "blocked_permissions": {
         "items": {
          "pattern": "^[a-z][a-zA-Z0-9.]*$",
          "type": "string"
         },
         "type": "array"
        },
        "installation_mode": {
         "enum": [
          "blocked",
          "allowed",
          "removed"
         ],
         "type": "string"
        }
       },
       "type": "object"
      }
     },
     "properties": {
      "*": {
       "properties": {
        "allowed_types": {
         "items": {
          "enum": [
           "extension",
           "theme",
           "user_script",
           "hosted_app",
           "legacy_packaged_app",
           "platform_app"
          ],
          "type": "string"
         },
         "type": "array"
        },
        "blocked_install_message": {
         "type": "string"
        },
        "blocked_permissions": {
         "items": {
          "pattern": "^[a-z][a-zA-Z0-9.]*$",
          "type": "string"
         },
         "type": "array"
        },
        "install_sources": {
         "items": {
          "type": "string"
         },
         "type": "array"
        },
        "installation_mode": {
         "enum": [
          "blocked",
          "allowed",
          "removed"
         ],
         "type": "string"
        },
        "runtime_allowed_hosts": {
         "items": {
          "type": "string"
         },
         "type": "array"
        },
        "runtime_blocked_hosts": {
         "items": {
          "type": "string"
         },
         "type": "array"
        }
       },
       "type": "object"
      }
     },
     "type": "object"
    }
    Copied to clipboard

    Example value (Windows):

    Software\Policies\Google\Chrome\ExtensionSettings = {
     "*": {
      "allowed_types": [
       "hosted_app"
      ],
      "blocked_install_message": "Custom error message.",
      "blocked_permissions": [
       "downloads",
       "bookmarks"
      ],
      "install_sources": [
       "https://company-intranet/chromeapps"
      ],
      "installation_mode": "blocked",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ]
     },
     "abcdefghijklmnopabcdefghijklmnop": {
      "blocked_permissions": [
       "history"
      ],
      "installation_mode": "allowed",
      "minimum_version_required": "1.0.1",
      "toolbar_pin": "force_pinned",
      "file_url_navigation_allowed": true
     },
     "bcdefghijklmnopabcdefghijklmnopa": {
      "allowed_permissions": [
       "downloads"
      ],
      "installation_mode": "force_installed",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ],
      "update_url": "https://example.com/update_url"
     },
     "cdefghijklmnopabcdefghijklmnopab": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "fghijklmnopabcdefghijklmnopabcde": {
      "blocked_install_message": "Custom removal message.",
      "installation_mode": "removed"
     },
     "ghijklmnopabcdefghijklmnopabcdef": {
      "installation_mode": "force_installed",
      "override_update_url": true,
      "update_url": "https://example.com/update_url"
     },
     "update_url:https://www.example.com/update.xml": {
      "allowed_permissions": [
       "downloads"
      ],
      "blocked_permissions": [
       "wallpaper"
      ],
      "installation_mode": "allowed"
     }
    }
    Copied to clipboard

    Example value (ChromeOS with Active Directory management):

    {
     "*": {
      "allowed_types": [
       "hosted_app"
      ],
      "blocked_install_message": "Custom error message.",
      "blocked_permissions": [
       "downloads",
       "bookmarks"
      ],
      "install_sources": [
       "https://company-intranet/chromeapps"
      ],
      "installation_mode": "blocked",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ]
     },
     "abcdefghijklmnopabcdefghijklmnop": {
      "blocked_permissions": [
       "history"
      ],
      "installation_mode": "allowed",
      "minimum_version_required": "1.0.1",
      "toolbar_pin": "force_pinned",
      "file_url_navigation_allowed": true
     },
     "bcdefghijklmnopabcdefghijklmnopa": {
      "allowed_permissions": [
       "downloads"
      ],
      "installation_mode": "force_installed",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ],
      "update_url": "https://example.com/update_url"
     },
     "cdefghijklmnopabcdefghijklmnopab": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "fghijklmnopabcdefghijklmnopabcde": {
      "blocked_install_message": "Custom removal message.",
      "installation_mode": "removed"
     },
     "ghijklmnopabcdefghijklmnopabcdef": {
      "installation_mode": "force_installed",
      "override_update_url": true,
      "update_url": "https://example.com/update_url"
     },
     "update_url:https://www.example.com/update.xml": {
      "allowed_permissions": [
       "downloads"
      ],
      "blocked_permissions": [
       "wallpaper"
      ],
      "installation_mode": "allowed"
     }
    }
    Copied to clipboard

    Example value (Linux):

    ExtensionSettings: {
     "*": {
      "allowed_types": [
       "hosted_app"
      ],
      "blocked_install_message": "Custom error message.",
      "blocked_permissions": [
       "downloads",
       "bookmarks"
      ],
      "install_sources": [
       "https://company-intranet/chromeapps"
      ],
      "installation_mode": "blocked",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ]
     },
     "abcdefghijklmnopabcdefghijklmnop": {
      "blocked_permissions": [
       "history"
      ],
      "installation_mode": "allowed",
      "minimum_version_required": "1.0.1",
      "toolbar_pin": "force_pinned",
      "file_url_navigation_allowed": true
     },
     "bcdefghijklmnopabcdefghijklmnopa": {
      "allowed_permissions": [
       "downloads"
      ],
      "installation_mode": "force_installed",
      "runtime_allowed_hosts": [
       "*://good.example.com"
      ],
      "runtime_blocked_hosts": [
       "*://*.example.com"
      ],
      "update_url": "https://example.com/update_url"
     },
     "cdefghijklmnopabcdefghijklmnopab": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
      "blocked_install_message": "Custom error message.",
      "installation_mode": "blocked"
     },
     "fghijklmnopabcdefghijklmnopabcde": {
      "blocked_install_message": "Custom removal message.",
      "installation_mode": "removed"
     },
     "ghijklmnopabcdefghijklmnopabcdef": {
      "installation_mode": "force_installed",
      "override_update_url": true,
      "update_url": "https://example.com/update_url"
     },
     "update_url:https://www.example.com/update.xml": {
      "allowed_permissions": [
       "downloads"
      ],
      "blocked_permissions": [
       "wallpaper"
      ],
      "installation_mode": "allowed"
     }
    }
    Copied to clipboard

    Example value (Mac):

    
    <key>ExtensionSettings</key>
    <dict>
    <key>*</key>
    <dict>
    <key>allowed_types</key>
    <array>
    <string>hosted_app</string>
    </array>
    <key>blocked_install_message</key>
    <string>Custom error message.</string>
    <key>blocked_permissions</key>
    <array>
    <string>downloads</string>
    <string>bookmarks</string>
    </array>
    <key>install_sources</key>
    <array>
    <string>https://company-intranet/chromeapps</string>
    </array>
    <key>installation_mode</key>
    <string>blocked</string>
    <key>runtime_allowed_hosts</key>
    <array>
    <string>*://good.example.com</string>
    </array>
    <key>runtime_blocked_hosts</key>
    <array>
    <string>*://*.example.com</string>
    </array>
    </dict>
    <key>abcdefghijklmnopabcdefghijklmnop</key>
    <dict>
    <key>blocked_permissions</key>
    <array>
    <string>history</string>
    </array>
    <key>installation_mode</key>
    <string>allowed</string>
    <key>minimum_version_required</key>
    <string>1.0.1</string>
    <key>toolbar_pin</key>
    <string>force_pinned</string>
    <key>file_url_navigation_allowed</key>
    <boolean>true</boolean>
    </dict>
    <key>bcdefghijklmnopabcdefghijklmnopa</key>
    <dict>
    <key>allowed_permissions</key>
    <array>
    <string>downloads</string>
    </array>
    <key>installation_mode</key>
    <string>force_installed</string>
    <key>runtime_allowed_hosts</key>
    <array>
    <string>*://good.example.com</string>
    </array>
    <key>runtime_blocked_hosts</key>
    <array>
    <string>*://*.example.com</string>
    </array>
    <key>update_url</key>
    <string>https://example.com/update_url</string>
    </dict>
    <key>cdefghijklmnopabcdefghijklmnopab</key>
    <dict>
    <key>blocked_install_message</key>
    <string>Custom error message.</string>
    <key>installation_mode</key>
    <string>blocked</string>
    </dict>
    <key>defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd</key>
    <dict>
    <key>blocked_install_message</key>
    <string>Custom error message.</string>
    <key>installation_mode</key>
    <string>blocked</string>
    </dict>
    <key>fghijklmnopabcdefghijklmnopabcde</key>
    <dict>
    <key>blocked_install_message</key>
    <string>Custom removal message.</string>
    <key>installation_mode</key>
    <string>removed</string>
    </dict>
    <key>ghijklmnopabcdefghijklmnopabcdef</key>
    <dict>
    <key>installation_mode</key>
    <string>force_installed</string>
    <key>override_update_url</key>
    <boolean>true</boolean>
    <key>update_url</key>
    <string>https://example.com/update_url</string>
    </dict>
    <key>update_url:https://www.example.com/update.xml</key>
    <dict>
    <key>allowed_permissions</key>
    <array>
    <string>downloads</string>
    </array>
    <key>blocked_permissions</key>
    <array>
    <string>wallpaper</string>
    </array>
    <key>installation_mode</key>
    <string>allowed</string>
    </dict>
    </dict>
    Copied to clipboard