Override Chrome pages

Stay organized with collections Save and categorize content based on your preferences.

Extensions can use HTML override pages to replace a page Google Chrome normally provides. An extension can contain an override for any of the following pages, but each extension can only override one page:

Bookmark Manager

The page that appears when the user chooses the Bookmark Manager menu item from the Chrome menu or, on Mac, the Bookmark Manager item from the Bookmarks menu. You can also get to this page by entering the URL chrome://bookmarks.

History

The page that appears when the user chooses the History menu item from the Chrome menu or, on Mac, the Show Full History item from the History menu. You can also get to this page by entering the URL chrome://history.

New Tab

The page that appears when the user creates a new tab or window. You can also get to this page by entering the URL chrome://newtab.

The following screenshots show the default New Tab page and then a custom New Tab page.

To try this out, see our override samples.

Incognito window behavior

In incognito windows, extensions can't override New Tab pages. Other pages still work if the incognito manifest property is set to "spanning" (the default value). For details on how to handle incognito windows, see Saving data and incognito mode.

Manifest

Use the following code to register an override page in the extension manifest:

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

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

For PAGE_TO_OVERRIDE, substitute one of the following:

• "bookmarks"
• "history"
• "newtab"

Best practices

• Make your page quick and small.
  Users expect built-in browser pages to open instantly. Avoid doing things that might take a long time. Specifically, avoid accessing database resources synchronously. When making network requests, prefer fetch() over XMLHttpRequest().

• To avoid user confusion, give your page a title.
  Without a title, the page title defaults to the URL. Specify the title using the