ADS Libraries

The ADS Libraries are intended to be the place for creating and curating collections of bibliographic records. whether it is for an article you are writing, a CV, or for sharing with colleagues. The libraries are much like the shopping basket found in services such as Amazon, and the features currently available are outlined below. The ADS Libraries are only available to users who have an ADS account, so head over to the sign up page first.

Creating and editing a library

There are two ways to create an ADS library:

a screenshot of the ads search results interface showing the ads libraries button

  1. Do a search on ADS bumblebee, select your relevant papers, and select the Add papers to library button. Fill in a library name and press submit.

  2. Go the My Account drop down and select ADS Libraries. Press the Create a library button.

It is possible to modify the name and description of the library you have created. To do this, simply navigate to the ADS Libraries page from the My Account drop down, at the top right of the web interface. Once there, you can select your library of interest, and press edit on the attribute you would like to modify.

To delete any of the records in your library, simply navigate to the library and press the red x next to the bibcode you do not want in the library. To delete the entire library, navigate to the library page, click on the “View Editing Options” button and select the “Delete library” option. Once deleted, a library is gone forever, so click with caution!

Making your library public and managing permissions

You can make your library publicly viewable to non-ADS users by going to the Manage Access tab within your ADS Libraries section under My Account. Press the Make this library public button to make it public. This button generates a unique URL that you can give to people to view your library. You have the option to make your library private again in the future, in the same part of the interface. By default, all libraries are private.

More detailed permissions and sharing will be available in the near future, and will be made available under the Manage Access panel.

Visualisations, metrics, and exports

Like the main search interface, you can make visualisations, look at metrics, and create exports for the bibcodes within your library.

To do so, simply navigate to your ADS Library via the button under My Account and then use the sub-menu buttons Export, Metrics, and Visualize. You can also access the same features by using the View this library in the ADS Search Results Page.

For details on these features, look at the main help pages.

Citation Helper

This option gives a list of 10 results which consists of publications that cite and/or are cited by papers in the list you just submitted, but they were not in this list. The process closely resembles the network approach of establishing “friends of friends”. Assuming that the bibcodes provided are all valid, it is still possible that no results will be returned. If results are returned, they have a score associated with them. This score essentially reflects how many “friends” know these other “friends”.

The envisioned use case for this is the following. While in the process of writing a paper, you maintain an ADS Library which represents the bibliography of your paper. When you think you are done, this tool may help you identify “missing” papers that might be considered for citation, or more simply, find papers very closely related to a set of papers that you have selected.

If there are any papers you would like to add to your library, select them an click the button “Add selected papers to this library”.


See the main API documentation for details on the ADS Libraries API.

Import from ADS Classic

Linking accounts

If you have accounts in our legacy systems, ADS Classic, it is possible to import libraries from your old accounts, into the new interface, ADS Bumblebee.

First login with your normal credentials on ADS Bumblebee, and then navigate yourself to the Customize Settings page:

a screenshot of the location of the Customize Settings button

Once there, select the panel Import Libraries:

a screenshot of ADS Classic library import with the form filled in

If you are linking an ADS Classic account, you will need to specify your email, your password used for your ADS Classic account, and the mirror at which you have an account.

If you need to link a different account, then simply press Sign into a new Classic account

Importing libraries

Once you have successfully connected your ADS Classic account with ADS Bumblebee, you now have the option to import your ADS Classic libraries into Bumblebee.

a screenshot after the Import all Classic libraries button has been pressed

You can now see my original ADS Classic library now exists in ADS Bumblebee:

ADS Classic a screenshot of the library in ADS Classic

ADS Bumblebee a screenshot of the library in ADS Bumblebee

ATTENTION: the following rules are used to import your libraries into the new interface

  1. All the libraries you own will be imported, and created with their ‘Name’ and ‘Description’ from ADS Classic. Entries for all bibcodes for each library will be created also.
  2. If you have a library in ADS Bumblebee with the same name, it will merge the documents from your ADS Classic library into Bumblebee; Bumblebee takes precedent.
  3. You can repeat this process as many times as you wish, but must keep in mind the actions of 2. and 3.
  4. You cannot undo your import, you must delete a library and re-import if you make a mistake.


  • I can’t seem to authenticate my ADS Classic account

    Make sure you i) actually have an ADS Classic account, and ii) that you selected the correct mirror - otherwise it won’t work. If you are still running into trouble, then contact us.

  • I can’t seem to import my libraries

    You should make sure you actually have any libraries to import from your ADS Classic library. It is more than likely you are trying to import from an account that does not have any. However, if you do have libraries and keep running into this problem then contact us.

  • I can’t find the export format for the software I’m trying to use

    If you think we should supply a format for another third-party software that is used then let us know.