Declare Permissions

To use most chrome.* APIs, your extension or app must declare its intent in the "permissions" field of the manifest. Each permission can be either one of a list of known strings (such as "geolocation") or a match pattern that gives access to one or more hosts. Permissions help to limit damage if your extension or app is compromised by malware. Some permissions are also displayed to users before installation, as detailed in Permission Warnings.

If an API requires you to declare a permission in the manifest, then its documentation tells you how to do so. For example, the Storage page shows you how to declare the "storage" permission.

Here's an example of the permissions part of a manifest file:

{{^is_apps}} 
"permissions": [
  "tabs",
  "bookmarks",
  "http://www.blogger.com/",
  "http://*.google.com/",
  "unlimitedStorage"
],
{{/is_apps}} {{?is_apps}} 
"permissions": [
  "serial",
  "storage",
  "videoCapture"
],
{{/is_apps}}

The following table lists the currently available permissions:

{{#permissions}} {{/permissions}}
Permission Description
"{{name}}" {{+description platform:platform name:name}}