Use the chrome_settings_overrides
key to override certain browser settings. Two settings are available:
"homepage"
, which enables you to override the browser's home page."search_provider"
, which enables you to add a new search engine.
"chrome_settings_overrides" : { "homepage": "https://developer.mozilla.org/" }
"chrome_settings_overrides": { "search_provider": { "name": "Discogs", "search_url": "https://www.discogs.com/search/?q={searchTerms}", "keyword": "disc", "favicon_url": "https://www.discogs.com/favicon.ico" } }
Manifest key: chrome_settings_overrides |
|
---|---|
Type | Object |
Mandatory | No |
Syntax
The chrome_settings_overrides
key is an object that may have the following properties:
Name | Type | Description |
---|---|---|
homepage |
String |
Defines the page to be used as the browser's homepage. The replacement is given as a URL. The URL may:
If two or more extensions both set this value, then the setting from the most recently installed one will take precedence. To override new tabs, use "chrome_url_overrides" instead. This is a localizable property. |
search_provider |
Object |
Defines a search provider to add to the browser. The search provider has a name and a primary search URL. Alternative URLs may be provided, including URLs for more specialized searches like image search. In the URL you supply, use " The search provider will be presented to the user alongside the built-in providers. If you include the This is an object with the properties listed below. All string properties are localizable.
|
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||
---|---|---|---|---|---|---|
chrome_settings_overrides | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
homepage | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.alternate_urls | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.encoding | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 65 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.favicon_url | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.image_url | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.image_url_post_params | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.instant_url | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.instant_url_post_params | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.is_default | Chrome Full support Yes | Edge Full support 79 | Firefox
Full support
57
| Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.keyword | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.name | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.prepopulated_id | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.search_url | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 55 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.search_url_post_params | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 64 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.suggest_url | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 64 | Opera No support No | Safari No support No | Firefox Android No support No |
search_provider.suggest_url_post_params | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 64 | Opera No support No | Safari No support No | Firefox Android No support No |
startup_pages | Chrome Full support Yes | Edge Full support 79 | Firefox No support No | Opera No support No | Safari No support No | Firefox Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.