The Astrophysics Data System Logo astrophysics data system

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:

  1. From the search results page, 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.

a screenshot of the ads search results interface showing the ads libraries 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 an account in our legacy system, ADS Classic, it is possible to import libraries from your old account into the new ADS interface.

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

a screenshot of the location of the Customize Settings button

Once there, select Import Libraries in the left panel:

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 the new ADS, you now have the option to import your ADS Classic libraries into the new ADS.

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

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

ADS Classic a screenshot of the library in ADS Classic

The new ADS a screenshot of the library in the new ADS

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. However, notes attached to individual entries within a library will not be imported and are not supported in the new ADS.
  2. If you have a library in the new ADS with the same name, it will merge the documents from your ADS Classic library into the new ADS; the new ADS 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.