Override Pages
true

Override pages are a way to substitute an HTML file from your extension for a page that Google Chrome normally provides. In addition to HTML, an override page usually has CSS and JavaScript code.

An extension can replace any one of the following pages:

Note: A single extension can override only one page.

The following screenshots show the default New Tab page next to a custom New Tab page.

The default New Tab page An alternative New Tab page
default New Tab page a blank New Tab page

Manifest

Register an override page in the extension manifest like this:

{
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "pageToOverride": "myPage.html"
  },
  ...
}

For pageToOverride, substitute one of the following:

Tips

For an effective override page, follow these guidelines:

Examples

You can find simple examples of defining override pages in the examples/api/override directory. For other examples and for help in viewing the source code, see Samples.