docs home

Searching for and choosing packages to download

You can use the npm search bar to find packages to use in your projects. npm search uses npms and the npms analyzer; for more information on both, see

Searching for a package

  1. In the search bar, type a search term and press Enter. As you type, possible choices will appear. [TK - fix screenshots]
  1. To list packages ranked according to package search rank criteria, in the left sidebar, under “Sort packages”, click the criterion. For example, to sort packages by popularity, click “Popularity”.
  2. In the package search results list, click the name of the package.

Package search rank criteria

Often, there are dozens or even hundreds of packages with similar names and/or similar purposes. To help you decide the best ones to explore, each package has been ranked according to four criteria using the npms analyzer:


Popularity indicates how many times the package has been downloaded. This is a strong indicator of packages that others have found to be useful.


Quality includes considerations such as the presence of a README file, stability, tests, up-to-date dependencies, custom website, and code complexity.


Maintenance ranks packages according to the attention they are given by developers. More frequently maintained packages are more likely to work well with the current or upcoming versions of the npm CLI, for example.


Optimal combines the other three criteria (popularity, quality, maintenance) into one score in a meaningful way.

< Getting packages from the registry | Downloading and installing packages globally >