Settings Overrides

Settings overrides are a way for extensions to override selected Chrome settings.

Homepage, Search Provider, and Startup Pages

Here is an example how homepage, search provider and startup pages can be modified in the extension manifest.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://www.foo.__MSG_url_domain__/image?q={searchTerms}",
        "search_url_post_params": "search_lang=__MSG_url_domain__",
        "suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
        "instant_url_post_params": "instant_lang=__MSG_url_domain__",
        "image_url_post_params": "image_lang=__MSG_url_domain__",
        "alternate_urls": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

Note: Settings overrides for homepage, search_provider, and startup_pages are only enabled in the Chrome Dev release.

Reference

An extension can override one or more of the following properties in the manifest:

• homepage (string)

  New value for the homepage.

• search_provider (object)

  A search engine

  Type	Attribute	Description
  string	name	Name of the search engine displayed to user.
  string	keyword	Omnibox keyword for the search engine.
  string	favicon_url	An icon URL for the search engine.
  string	search_url	An search URL used by the search engine.
  string	encoding	Encoding of the search term.
  string	(optional) suggest_url	If omitted, this engine does not support suggestions.
  string	(optional) instant_url	If omitted, this engine does not support instant.
  string	(optional) image_url	If omitted, this engine does not support image search.
  string	(optional) search_url_post_params	The string of post parameters to search_url
  string	(optional) suggest_url_post_params	The string of post parameters to suggest_url
  string	(optional) instant_url_post_params	The string of post parameters to instant_url
  string	(optional) image_url_post_params	The string of post parameters to image_url
  array of string	(optional) alternate_urls	A list of URL patterns that can be used, in addition to |search_url|.
  boolean	is_default	Specifies if the search provider should be default.

• startup_pages (array of string)

  URLs to be added to the list of startup pages.