manifest.schema.json

{
    "title": "Chrome Extension Manifest",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "additionalProperties": false,
    "type": "object",
    "properties": {
        "action": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "default_icon": {
                    "type": "object",
                    "properties": {
                        "16": {
                            "type": "string"
                        },
                        "24": {
                            "type": "string"
                        },
                        "32": {
                            "type": "string"
                        }
                    }
                },
                "default_title": {
                    "type": "string"
                },
                "default_popup": {
                    "type": "string",
                    "default": "popup.html"
                }
            },
            "description": "Use the chrome.action API to control the extension's icon in the Google Chrome toolbar."
        },
        "background": {
            "$ref": "#/definitions/background"
        },
        "chrome_settings_overrides": {
            "$ref": "#/definitions/chrome_settings_overrides"
        },
        "chrome_url_overrides": {
            "additionalProperties": false,
            "description": "Override pages are a way to substitute an HTML file from your extension for a page that Google Chrome normally provides.",
            "maxProperties": 1,
            "properties": {
                "bookmarks": {
                    "$ref": "#/definitions/page",
                    "default": "bookmarks.html",
                    "description": "The page that appears when the user chooses the Bookmark Manager menu item from the Chrome menu or, on Mac, the Bookmark Manager item from the Bookmarks menu. You can also get to this page by entering the URL chrome://bookmarks."
                },
                "history": {
                    "$ref": "#/definitions/page",
                    "default": "history.html",
                    "description": "The page that appears when the user chooses the History menu item from the Chrome menu or, on Mac, the Show Full History item from the History menu. You can also get to this page by entering the URL chrome://history."
                },
                "newtab": {
                    "$ref": "#/definitions/page",
                    "default": "newtab.html",
                    "description": "The page that appears when the user creates a new tab or window. You can also get to this page by entering the URL chrome://newtab."
                }
            },
            "type": "object"
        },
        "commands": {
            "description": "Use the commands API to add keyboard shortcuts that trigger actions in your extension, for example, an action to open the browser action or send a command to the extension.",
            "patternProperties": {
                ".*": {
                    "$ref": "#/definitions/command"
                },
                "^_execute_browser_action$": {
                    "$ref": "#/definitions/command"
                },
                "^_execute_page_action$": {
                    "$ref": "#/definitions/command"
                }
            },
            "type": "object"
        },
        "content_scripts": {
            "type": "array",
            "uniqueItems": true,
            "items": {
                "$ref": "#/definitions/content_script"
            },
            "description": "Content scripts are JavaScript files that run in the context of web pages."
        },
        "content_security_policy": {
            "$ref": "#/definitions/content_security_policy"
        },
        "current_locale": {},
        "default_locale": {
            "type": "string",
            "default": "en",
            "description": "Specifies the subdirectory of _locales that contains the default strings for this extension."
        },
        "description": {
            "type": "string",
            "maxLength": 132,
            "description": "A plain text description of the extension"
        },
        "devtools_page": {
            "$ref": "#/definitions/page",
            "description": "A DevTools extension adds functionality to the Chrome DevTools. It can add new UI panels and sidebars, interact with the inspected page, get information about network requests, and more."
        },
        "externally_connectable": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "ids": {
                    "type": "array",
                    "items": {
                        "description": "The IDs of extensions or apps that are allowed to connect. If left empty or unspecified, no extensions or apps can connect.",
                        "type": "string"
                    }
                },
                "matches": {
                    "type": "array",
                    "items": {
                        "description": "The URL patterns for web pages that are allowed to connect. This does not affect content scripts. If left empty or unspecified, no web pages can connect.",
                        "type": "string"
                    }
                },
                "accepts_tls_channel_id": {
                    "type": "boolean",
                    "default": false,
                    "description": "Indicates that the extension would like to make use of the TLS channel ID of the web page connecting to it. The web page must also opt to send the TLS channel ID to the extension via setting includeTlsChannelId to true in runtime.connect's connectInfo or runtime.sendMessage's options."
                }
            },
            "description": "Declares which extensions, apps, and web pages can connect to your extension via runtime.connect and runtime.sendMessage."
        },
        "file_browser_handlers": {
            "type": "array",
            "minItems": 1,
            "items": {
                "additionalProperties": false,
                "properties": {
                    "id": {
                        "type": "string",
                        "description": "Used by event handling code to differentiate between multiple file handlers"
                    },
                    "default_title": {
                        "type": "string",
                        "description": "What the button will display."
                    },
                    "file_filters": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                            "type": "string"
                        },
                        "description": "Filetypes to match."
                    }
                },
                "required": [
                    "id",
                    "default_title",
                    "file_filters"
                ],
                "type": "object"
            },
            "description": "You can use this API to enable users to upload files to your website."
        },
        "homepage_url": {
            "$ref": "#/definitions/uri",
            "description": "The URL of the homepage for this extension."
        },
        "icons": {
            "type": "object",
            "minProperties": 1,
            "properties": {
                "16": {
                    "$ref": "#/definitions/icon",
                    "description": "Used as the favicon for an extension's pages and infobar."
                },
                "48": {
                    "$ref": "#/definitions/icon",
                    "description": "Used on the extension management page (chrome://extensions)."
                },
                "128": {
                    "$ref": "#/definitions/icon",
                    "description": "Used during installation and in the Chrome Web Store."
                },
                "256": {
                    "$ref": "#/definitions/icon",
                    "description": "Used during installation and in the Chrome Web Store."
                }
            },
            "description": "One or more icons that represent the extension, app, or theme. Recommended format: PNG; also BMP, GIF, ICO, JPEG."
        },
        "import": {
            "type": "array",
            "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "minimum_version": {
                        "type": "string"
                    }
                },
                "required": [ "id" ]
            }
        },
        "incognito": {
            "type": "string",
            "default": "spanning",
            "enum": [
                "spanning",
                "split",
                "not_allowed"
            ],
            "description": "Specify how this extension will behave if allowed to run in incognito mode."
        },
        "input_components": {
            "type": "array",
            "items": {
                "additionalProperties": false,
                "properties": {
                    "description": {
                        "type": "string"
                    },
                    "id": {
                        "type": "string"
                    },
                    "language": {
                        "type": "string"
                    },
                    "layouts": {
                        "type": "array"
                    },
                    "name": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    }
                },
                "required": [
                    "name",
                    "type",
                    "id",
                    "description",
                    "language",
                    "layouts"
                ],
                "type": "object"
            },
            "description": "Allows your extension to handle keystrokes, set the composition, and manage the candidate window."
        },
        "key": {
            "type": "string",
            "description": "This value can be used to control the unique ID of an extension, app, or theme when it is loaded during development."
        },
        "manifest_version": {
            "type": "number",
            "enum": [
                3
            ],
            "maximum": 3,
            "minimum": 3,
            "description": "One integer specifying the version of the manifest file format your package requires."
        },
        "minimum_chrome_version": {
            "$ref": "#/definitions/version_string",
            "description": "The version of Chrome that your extension, app, or theme requires, if any."
        },
        "nacl_modules": {
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "items": {
                "additionalProperties": false,
                "properties": {
                    "path": {
                        "$ref": "#/definitions/uri",
                        "description": "The location of a Native Client manifest (a .nmf file) within the extension directory."
                    },
                    "mime_type": {
                        "$ref": "#/definitions/mime_type",
                        "description": "The MIME type for which the Native Client module will be registered as content handler."
                    }
                },
                "required": [
                    "path",
                    "mime_type"
                ],
                "type": "object"
            },
            "description": "One or more mappings from MIME types to the Native Client module that handles each type."
        },
        "name": {
            "type": "string",
            "maxLength": 45,
            "description": "The name of the extension"
        },
        "oauth2": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "client_id": {
                    "description": "You need to register your app in the Google APIs Console to get the client ID.",
                    "type": "string"
                },
                "scopes": {
                    "items": {
                        "type": "string"
                    },
                    "minItems": 1,
                    "type": "array"
                }
            },
            "required": [
                "client_id",
                "scopes"
            ],
            "description": "Use the Chrome Identity API to authenticate users: the getAuthToken for users logged into their Google Account and the launchWebAuthFlow for users logged into a non-Google account."
        },
        "offline_enabled": {
            "type": "boolean",
            "description": "Whether the app or extension is expected to work offline. When Chrome detects that it is offline, apps with this field set to true will be highlighted on the New Tab page."
        },
        "omnibox": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "keyword": {
                    "description": "The keyward that will trigger your extension.",
                    "type": "string"
                }
            },
            "required": [
                "keyword"
            ],
            "description": "The omnibox API allows you to register a keyword with Google Chrome's address bar, which is also known as the omnibox."
        },
        "optional_permissions": {
            "$ref": "#/definitions/permissions",
            "description": "Use the chrome.permissions API to request declared optional permissions at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary."
        },
        "options_page": {
            "$ref": "#/definitions/page",
            "default": "options.html",
            "description": "To allow users to customize the behavior of your extension, you may wish to provide an options page. If you do, a link to it will be provided from the extensions management page at chrome://extensions. Clicking the Options link opens a new tab pointing at your options page."
        },
        "options_ui": {
            "type": "object",
            "properties": {
                "open_in_tab": {
                    "default": false,
                    "description": "If true, your extension's options page will be opened in a new tab rather than embedded in chrome://extensions. The default is false, and we recommend that you don't change it. This is only useful to delay the inevitable deprecation of the old options UI! It will be removed soon, so try not to use it. It will break.",
                    "type": "boolean"
                },
                "page": {
                    "description": "The path to your options page, relative to your extension's root.",
                    "type": "string"
                }
            },
            "required": [
                "page"
            ],
            "description": "To allow users to customize the behavior of your extension, you may wish to provide an options page. If you do, an Options link will be shown on the extensions management page at chrome://extensions which opens a dialogue containing your options page."
        },
        "permissions": {
            "$ref": "#/definitions/permissions",
            "description": "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."
        },
        "host_permissions": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "platforms": {},
        "requirements": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "3D": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                        "features": {
                            "type": "array",
                            "minItems": 1,
                            "uniqueItems": true,
                            "items": {
                                "enum": [
                                    "webgl"
                                ],
                                "type": "string"
                            },
                            "description": "List of the 3D-related features your app requires."
                        }
                    },
                    "required": [
                        "features"
                    ],
                    "description": "The '3D' requirement denotes GPU hardware acceleration."
                },
                "plugins": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                        "npapi": {
                            "type": "boolean",
                            "default": true
                        }
                    },
                    "required": [
                        "npapi"
                    ],
                    "description": "Indicates if an app or extension requires NPAPI to run. This requirement is enabled by default when the manifest includes the 'plugins' field."
                }
            },
            "description": "Technologies required by the app or extension. Hosting sites such as the Chrome Web Store may use this list to dissuade users from installing apps or extensions that will not work on their computer."
        },
        "sandbox": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "pages": {
                    "type": "array",
                    "minItems": 1,
                    "uniqueItems": true,
                    "items": {
                        "$ref": "#/definitions/page"
                    }
                },
                "content_security_policy": {
                    "$ref": "#/definitions/content_security_policy",
                    "default": "sandbox allow-scripts allow-forms"
                }
            },
            "required": [
                "pages"
            ],
            "description": "Defines an collection of app or extension pages that are to be served in a sandboxed unique origin, and optionally a Content Security Policy to use with them."
        },
        "short_name": {
            "type": "string",
            "maxLength": 12,
            "description": "The short name is typically used where there is insufficient space to display the full name."
        },
        "storage": {
            "type": "object",
            "properties": {
                "managed_schema": {
                    "type": "string"
                }
            }
        },
        "system_indicator": {},
        "tts_engine": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "voices": {
                    "type": "array",
                    "minItems": 1,
                    "uniqueItems": true,
                    "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                            "voice_name": {
                                "type": "string",
                                "description": "Identifies the name of the voice and the engine used."
                            },
                            "lang": {
                                "type": "string",
                                "description": "Almost always, a voice can synthesize speech in just a single language. When an engine supports more than one language, it can easily register a separate voice for each language."
                            },
                            "event_types": {
                                "description": "Events sent to update the client on the progress of speech synthesis.",
                                "items": {
                                    "description": "",
                                    "enum": [
                                        "start",
                                        "word",
                                        "sentence",
                                        "marker",
                                        "end",
                                        "error"
                                    ],
                                    "type": "string"
                                },
                                "minItems": 1,
                                "type": "array",
                                "uniqueItems": true
                            }
                        },
                        "required": [
                            "voice_name",
                            "event_types"
                        ]
                    },
                    "description": "Voices the extension can synthesize."
                }
            },
            "required": [
                "voices"
            ],
            "description": "Register itself as a speech engine."
        },
        "update_url": {
            "$ref": "#/definitions/uri",
            "description": "If you publish using the Chrome Developer Dashboard, ignore this field. If you host your own extension or app: URL to an update manifest XML file."
        },
        "version": {
            "$ref": "#/definitions/version_string",
            "description": "One to four dot-separated integers identifying the version of this extension."
        },
        "version_name": {
            "type": "string",
            "description": "In addition to the version field, which is used for update purposes, version_name can be set to a descriptive version string and will be used for display purposes if present."
        },
        "web_accessible_resources": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
                "$ref": "#/definitions/web_accessible_resource"
            },
            "description": "An array of strings specifying the paths (relative to the package root) of packaged resources that are expected to be usable in the context of a web page."
        }
    },
    "required": [
        "manifest_version",
        "name",
        "version"
    ],
    "dependencies": {
    },
    "definitions": {
        "command": {
            "additionalProperties": false,
            "properties": {
                "description": {
                    "type": "string"
                },
                "suggested_key": {
                    "additionalProperties": false,
                    "patternProperties": {
                        "^(default|mac|windows|linux|chromeos)$": {
                            "pattern": "^(Ctrl|Command|MacCtrl|Alt|Option)\\+(Shift\\+)?[A-Z]",
                            "type": "string"
                        }
                    },
                    "type": "object"
                }
            },
            "type": "object"
        },
        "content_security_policy": {
            "default": "script-src 'self'; object-src 'self'",
            "description": "This introduces some fairly strict policies that will make extensions more secure by default, and provides you with the ability to create and enforce rules governing the types of content that can be loaded and executed by your extensions and applications.",
            "format": "content-security-policy",
            "type": "string"
        },
        "icon": {
            "$ref": "#/definitions/uri"
        },
        "match_pattern": {
            "format": "match-pattern",
            "pattern": "^((\\*|http|https|file|ftp|chrome-extension):\\/\\/(\\*|(([^\\/\\*:]+:(\\d{1,5}|\\*)))|(\\*\\.[^\\/\\*\\:]+)|[^\\/\\*\\:]+)?(\\/.*))|<all_urls>$",
            "type": "string"
        },
        "mime_type": {
            "format": "mime-type",
            "pattern": "^(?:application|audio|image|message|model|multipart|text|video)\\/[-+.\\w]+$",
            "type": "string"
        },
        "page": {
            "$ref": "#/definitions/uri"
        },
        "permissions": {
            "items": {
                "format": "permission",
                "type": "string"
            },
            "type": "array",
            "uniqueItems": true
        },
        "uri": {
            "type": "string"
        },
        "version_string": {
            "pattern": "^(?:\\d{1,5}\\.){0,3}\\d{1,5}$",
            "type": "string"
        },
        "background": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "service_worker": {
                    "type": "string",
                    "default": "background.js",
                    "description": "Specify the service worker of the background page."
                }
            },
            "required": ["service_worker"],
            "description": "The background page is an HTML page that runs in the extension process. It exists for the lifetime of your extension, and only one instance of it at a time is active."
        },
        "content_script": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "matches": {
                    "type": "array",
                    "uniqueItems": true,
                    "minItems": 1,
                    "items": {
                        "$ref": "#/definitions/match_pattern"
                    },
                    "description": "Specifies which pages this content script will be injected into."
                },
                "css": {
                    "type": "array",
                    "uniqueItems": true,
                    "items": {
                        "$ref": "#/definitions/uri"
                    },
                    "description": "The list of CSS files to be injected into matching pages. These are injected in the order they appear in this array, before any DOM is constructed or displayed for the page."
                },
                "js": {
                    "type": "array",
                    "uniqueItems": true,
                    "items": {
                        "$ref": "#/definitions/uri"
                    },
                    "description": "The list of JavaScript files to be injected into matching pages. These are injected in the order they appear in this array."
                },
                "match_about_blank": {
                    "type": "boolean",
                    "default": false,
                    "description": "Whether the script should inject into an about:blank frame where the parent or opener frame matches one of the patterns declared in matches. Defaults to false."
                }
            },
            "required": [
                "matches"
            ]
        },
        "web_accessible_resource": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "resources": {
                    "type": "array",
                    "description": "",
                    "items": {
                        "type": "string"
                    }
                },
                "matches": {
                    "type": "array",
                    "description": "",
                    "items": {
                        "type": "string"
                    }
                },
                "extension_ids": {
                    "type": "array",
                    "description": "",
                    "items": {
                        "type": "string"
                    }
                },
                "use_dynamic_url": {
                    "type": "boolean",
                    "description": ""
                }
            },
            "required": [ "resources" ]
        },
        "chrome_settings_overrides": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "homepage": {
                    "$ref": "#/definitions/uri"
                },
                "search_provider": {
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string"
                        },
                        "keyword": {
                            "type": "string"
                        },
                        "search_url": {
                            "$ref": "#/definitions/uri"
                        },
                        "favicon_url": {
                            "$ref": "#/definitions/uri"
                        },
                        "suggest_url": {
                            "$ref": "#/definitions/uri"
                        },
                        "instant_url": {
                            "$ref": "#/definitions/uri"
                        },
                        "image_url": {
                            "$ref": "#/definitions/uri"
                        },
                        "search_url_post_params": {
                            "type": "string"
                        },
                        "suggest_url_post_params": {
                            "type": "string"
                        },
                        "instant_url_post_params": {
                            "type": "string"
                        },
                        "image_url_post_params": {
                            "type": "string"
                        },
                        "alternate_urls": {
                            "type": "array",
                            "items": {
                                "$ref": "#/definitions/uri"
                            }
                        },
                        "prepopulated_id": {
                            "type": "number"
                        },
                        "encoding": {
                            "type": "string"
                        },
                        "is_default": {
                            "type": "boolean"
                        }
                    },
                    "required": [
                        "search_url",
                        "is_default"
                    ]
                },
                "startup_pages": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/uri"
                    }
                }
            }
        }
    }
}