chrome_settings_overrides
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
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
chrome_settings_overrides | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
homepage | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.alternate_urls | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.encoding | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support65 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.favicon_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.image_url | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.image_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.instant_url | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.instant_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.is_default | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support57
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.keyword | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.name | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.prepopulated_id | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.search_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.search_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.suggest_url | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
search_provider.suggest_url_post_params | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support64 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
startup_pages | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidNo supportNo |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.