chrome_settings_overrides
Type | Object |
---|---|
Mandatory | No |
Manifest version | 2 or higher |
Example | "chrome_settings_overrides" : { "homepage": "https://developer.mozilla.org/" }, |
Use the chrome_settings_overrides
key to override the browser's home page and add a new search engine.
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.
|
Example
This example shows how to set a search provider.
"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"
}
}
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
chrome_settings_overrides | |||||||
homepage | |||||||
search_provider | |||||||
search_provider.alternate_urls | |||||||
search_provider.encoding | |||||||
search_provider.favicon_url | |||||||
search_provider.image_url | |||||||
search_provider.image_url_post_params | |||||||
search_provider.instant_url | |||||||
search_provider.instant_url_post_params | |||||||
search_provider.is_default | |||||||
search_provider.keyword | |||||||
search_provider.name | |||||||
search_provider.prepopulated_id | |||||||
search_provider.search_url | |||||||
search_provider.search_url_get_params | |||||||
search_provider.search_url_post_params | |||||||
search_provider.suggest_url | |||||||
search_provider.suggest_url_get_params | |||||||
search_provider.suggest_url_post_params | |||||||
startup_pages |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.