Google Chrome Extensions

chrome.topSites

Notes

The top sites module allows access to the top sites that are displayed on the new tab page.

Manifest

You must declare the "topSites" permission in your extension's manifest to use this API. 

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

Examples

You can find samples of this API in Samples.

API Reference: chrome.topSites

Types

MostVisitedURL

( object )
An object encapsulating a most visited URL, such as the URLs on the new tab page.

Properties of MostVisitedURL

url ( string )
The most visited URL.
title ( string )
The title of the page

Methods

get

chrome.topSites.get()

Gets a list of top sites.

Sample Extensions that use chrome.topSites

  • NTP prototyping extension – extension to prototype new NTP designs