- Linking Guidelines
JSTOR encourages the use of links to facilitate access to the Content by Authorized Users and Institutional Licensees, including but not limited to links to online syllabi, bibliographies, and reading lists. All Content has a stable URL that can be found in the Browse and Search interfaces of JSTOR's website as well as on the Article Information page each discrete Content item. Further information on establishing stable links to material in JSTOR may be obtained from User Support (email@example.com
- For some titles, JSTOR displays citation information and an outside link to the full-text of recently published articles that are hosted on external sites.
For these titles, users are able to search and browse for the title, author, and abstract information for articles in the recent issues in addition to searching the full text for the past articles in JSTOR archive. Users with a subscription to the journals held by our current issue providers, either through their library or individually, are able to follow direct links to the full-text articles available through these providers.
If an institution has an OpenURL link resolver, we are able to replace these links to external content with a link back to their link resolver. If you would like us activate OpenURL linking, please send your Base URL and custimized OpenURL button image (optional) to firstname.lastname@example.org.
- JSTOR Metadata Partners
We provide JSTOR metadata for books and journals, updated on a weekly basis, to the following organizations for indexing in their web-scale discovery platforms:
EBSCO - EDS
Ex Libris - Primo Central
OCLC - WorldCat Discovery Service
Serials Solutions (ProQuest) - Summon
TDNet - TDNet Discover
- Welcome to Discovery & Linking
Welcome to Discovery & Linking at JSTOR! In the Discovery & Linking section, you will find information related to content discovery and linking activities at JSTOR, for both participating libraries and discovery/linking partners. Some helpful topics include:-Updates on new collections, content packages, technical issues in News & Alerts.
-Quick Reference Guides to assist libraries with increasing the discoverability of their subscribed JSTOR content within the major web-scale discovery services and institutional link resolvers
-JSTOR metadata and web-scale discovery integration
-Metasearching with the JSTOR XML Search Gateway
-Linking functionality and integration on the JSTOR platform
-Title lists for the JSTOR Archive Collections, Books at JSTOR Collections, and Current Scholarship Program subscription packages
- JSTOR has created Quick Reference Guides (QRGs) for link resolver and indexed discovery products offered by EBSCO, Ex Libris and ProQuest. Note that a Guide for OCLC's WorldCat Discovery Services will be available in the near future.
These Guides are designed to help librarians configure their discovery services to most effectively surface content that is most highly valued by their users. JSTOR’s recent research shows that, unless discovery services are configured correctly, usage of content on our platform (for example) can drop significantly.
We encourage participating librarians to make the most of their investments in JSTOR by downloading and reviewing the relevant QRG(s) from our Quick Reference Guides page.
The products covered by the QRGs are:
EBSCO: LinkSource and EDS
Ex Libris: Alma, Primo, and SFX
OCLC: WorldCat Discovery Services (coming soon)
ProQuest: 360 Link and Summon
- Quick Links
JSTOR Fact Sheet
: provides a summary of the collections/packages available for the different content types on the JSTOR platform: JSTOR Archive, Books at JSTOR, JSTOR Current Scholarship Program, and JSTOR Primary Source.
JSTOR Title Lists
: download KBART compliant title lists for the collections and content packages available on the JSTOR platform.
- As part of our continued effort to increase the convenience of access to the archive, we developed an interface to the JSTOR Search Engine called the JSTOR XML Gateway. It was created to better facilitate metasearching, which is also known as "federated searching" or "cross-database searching". As some of our participating institutions have chosen to implement a metasearch engine for their users, we recognized the need to provide both a stable, standardized method for querying the JSTOR archive and also a manner of returning results that could be easily utilized by a metasearch program. To accomplish this, we have chosen the Search and Retrieve URL (SRU) Service as the basis for the JSTOR XML Gateway.
The SRU Service is a Web Services-based protocol for querying databases and returning search results and incorporates elements of the Z39.50 protocol for Information Retrieval. The JSTOR XML Gateway was designed using SRW/U Open Source Software, developed by Online Computer Library Center Research, as a basis for implementation.
The SRU Service uses the Contextual Query Language (CQL) as the format for submitting search queries. Although CQL is a formal language for representing queries to information retrieval systems, it has been designed to be human-readable and writable. It allows for both very simple queries as well as complex, powerful queries involving Boolean operators, nesting, etc. The search results are returned as XML records in Dublin Core format and are listed in order of relevancy ranking. By providing the search results in XML (short for eXtensible Markup Language), the JSTOR XML Gateway transfers article metadata in a standard format to the metasearch engine for display to the user. To learn more about SRU and the related protocol of Search and Retrieve Web Service (SRW), please visit: http://www.loc.gov/standards/sru/
- Requesting JSTOR Metadata
Both participating JSTOR institutions and non-participating organizations may license JSTOR metadata for the JSTOR Archive, Current Scholarship Program, and Books at JSTOR.
Non-participating institutions requests will be reviewed by our Discovery & Linking staff to ensure that we are building the most appropriate relationships for our participating libraries. As a first step, to help our staff evaluate metadata requests, please complete the Metadata Sharing Questionnaire
and return it to email@example.com
. Non-participating institutions are required to sign a JSTOR Data License Agreement
before receiving JSTOR metadata.
- Content Linking
JSTOR is dedicated to providing a trusted electronic archive of scholarly journals. In balancing the interests of publishers, libraries, and users, JSTOR archival collections do not include access to the most recent issues of journals to ensure that publisher interests are not undermined. However, the digital environment offers opportunities to link together disparate and related resources, and we have been working hard to develop a program that joins the back issues with the more recent issues in a way that makes the experience for users as seamless as possible. For this reason, JSTOR supports and encourages its participating institutions’ use of link resolvers.
- Institutional Holdings Information
We are also in the process of developing a service that will allow institutions to requests holdings files for their licensed Books at JSTOR content. An announcement will be made when book holdings files are available to request.
- Accessing the JSTOR XML Gateway
Participating institutions are required to sign a JSTOR Metasearch Rider
in addition to their existing Institutional Participation Agreement before we will enable access to the XML Gateway. If you are a current JSTOR Participant, please complete the Metasearch Rider and return to firstname.lastname@example.org
. The JSTOR Discovery team will then contact you with additional information about using the search API.
Requests to access the search API from non-participating institutions will be reviewed by our Discovery & Linking staff to ensure that we are building the most appropriate relationships for our participating libraries. If approved, non-participating institutions will be required to sign a JSTOR Metasearch Agreement
. Please review the Agreement and contact email@example.com
, including the following information in your request:
-Name of your product/service
-Link to user interface or demo
-Primary technical contact
-Overview of your search product
Once the proper Agreement has been signed, we will provide a copy of the JSTOR XML Gateway Usage Guide and enable your IP addresses.
- JSTOR supports OpenURL linking for all content. Users at institutions that have activated a link resolver for use with JSTOR will see OpenURL links for all content in collections not licensed by their institutions, as well as for links to current issues content on partner sites.
To activate OpenURL links for your institution, please send the following information to JSTOR User Support:
+ The Base URL for your linking server (for example, http://sfxserver.uni.edu/sfxmenu, http://ab12cd34ef.search.serialssolutions.com/)
+ (optional) If you would like a customized button to appear instead of the generic JSTOR button, then please send us your .gif or .jpeg image as an attachment, or a URL from where we can download the image. For accessibility and formatting reasons, your image must be at least 20 pixels in height and have a maximum width of 150 pixels.
- Receiving JSTOR Metadata
After the JSTOR Metadata Sharing Amendment or JSTOR Metadata Sharing License Agreement has been signed, our Discovery staff will set up a metadata deposit to be delivered via FTP. Upon completing the appropriate metadata license agreement, please review the JSTOR Metadata Recipient Information
document and submit the required information to firstname.lastname@example.org
- In addition to accessing content directly from your library’s site, users might also find, through Google Scholar results, JSTOR content that you license. This process is possible due to a partnership between JSTOR and Google Scholar. JSTOR compiles the IP addresses and corresponding licenses of our participating institutions and makes them available in a space that Google Scholar regularly crawls. When Google Scholar sees a user coming from an IP address that is associated with a participating institution, and that user’s search returns results to which they have access on JSTOR, that user will see a link to JSTOR next to the result.
In some cases, our database may be out of sync with your institution's IP addresses. This may happen if your ISP has recently changed, or if your network layout or infrastructure has been modified. Please contact JSTOR Support if you have updated IP addresses, or if you have any questions about what users are or aren’t seeing based on this relationship.
- Journals + Primary Source Content
JSTOR creates and enters new cataloging records or updates existing cataloging records in OCLC for each title, current or previous, in the archive. The records include the URL for each title in the 856 MARC field.
Currently, the only way to locate all the cataloging records for each title in a JSTOR collection is to conduct a title-by-title search in OCLC. When reviewing records for potential downloading to your local system, please ensure that there is not a MARC field indicating “Record reported for deletion.” In such cases, a different record should be located and reviewed for downloading.
Books at JSTOR
Books at JSTOR offers free, high-quality MARC records from OCLC. The MARC records are available to all participating institutions, regardless of whether they are OCLC affiliates.
You can download sample MARC records here
(in .mrc format). A detailed guide to setting up OCLC Collection Manager to receive MARC records for Books at JSTOR titles is available here
- JSTOR XML Gateway Content
The following content is available in the XML Gateway search index:
-JSTOR Archive Collections
-Books at JSTOR
-JSTOR Current Scholarship Program Journals
-19th Century British Pamphlets
Please note that the two Aluka Collections, Cultural Heritage and Struggles for Freedom, and Global Plants content are not available in the API search index.
- About JSTOR Metadata
The XML files for each of Archives, Current Journal content, and Books were created from data JSTOR has in its delivery system. An effort has been made to both use specific tag sets (JATS 1.0 Archiving for journals, and the draft BITS 0.2 for books), and to make the data more consistent. JSTOR's journal content, and CSP content in particular, represents a variety of practice and markup philosophy across publishers and time.
- Base URL for JSTOR:
Supported OpenURL v0.1 parameters:
title- Book/Journal title
aulast- author last name
aufirst - author firstname
volume- This is applicable for article
issue- This is applicable for article
spage- start page
issn - journal
isbn - book
date - Publication date (YYYY or YYYY-MM or YYYY-MM-DD)
id=doi:XXXX - DOI (where XXXX is the ID value)
Supported OpenURL v1.0 parameters:
rft_id=info:doi - identifier
Sample OpenURL link to journal article:
Sample OpenURL link to book:
- SICI Linking
The JSTOR platform supports linking to journal articles via the SICI standard. While we will continue to support SICI linking, we advise that linking partners use OpenURL syntax for the most reliable linking experience. Wikipedia provides a sufficient explanation of the SICI elements:
The SICI code is composed of three segments, intended to be both human-readable and easy for machines to parse automatically. The following example SICI is explained below:
The Influence of Reflection Coefficient Statistics on the Seismic Method: Scattering Attenuation and Transmission Wavelets
J. W. J. Hosken, S. K. Mayo and A. T. Walden
Proceedings: Mathematical and Physical Sciences, Vol. 439, No. 1905 (Oct. 8, 1992), pp. 1-23
Published by: The Royal Society
Article Stable URL: http://www.jstor.org/stable/2646874
This is the ISSN for the periodical, in this case Proceedings: Mathematical and Physical Sciences.
The chronology part is in parentheses and identifies the date of publication. In this case, it is signified by year, month, and date: 1992, October 8
The enumeration part signifies the volume and number; Vol. 439, No. 1905
Signifies the start of the contribution segment
Location code: signifies the page number, frame number, reel number, etc. In this case, page 1
Title code: based on the title of the article. In this case, an initialism: "The Influence of Reflection Coefficient Statistics…"
Signifies the end of the contribution segment
Code Structure Identifier (CSI) for the type of SICI being constructed
Derivative Part Identifier (DPI) identifies a part of the contribution, such as a table of contents or abstract
Format identifier two-letter code signifying the way content is presented. In this case, CO = online
Standard version number
Check Character: an alpha-numeric character calculated from the SICI string
Here is the SICI link to JSTOR for this article:
- JSTOR has created Quick Reference Guides (QRGs) for link resolver and indexed discovery products offered by EBSCO, Ex Libris and ProQuest. These Guides are designed to help librarians configure their discovery services to most effectively surface content that is most highly valued by their users. JSTOR’s recent research shows that, unless discovery services are configured correctly, usage of content on the JSTOR platform (for example) can drop significantly. We encourage participating librarians to make the most of their investments in JSTOR by downloading and reviewing the relevant QRG(s) from our Quick Reference Guides page.
- 09/22/2014: New Archive Collection - Iberoamérica
JSTOR has released a new Archive Collection called Iberoamérica. The JSTOR Iberoamérica Collecton is a multidisciplinary collection of journals published within or about the Ibero-American world. The collection serves scholars across the humanities and social sciences in Latin America, the Caribbean, Spain, Portugal, and beyond. A title list for this collection can be found here
and on our JSTOR Title Lists
page. Discovery partners licensing metadata for the JSTOR Archive will receive a notification when metadata for this collection is available. Please contact email@example.com
with any questions.
- 04/25/2014: New Archive Collection - Arts & Sciences XIII
JSTOR has recently launched a new Archive Collection: Arts & Sciences XIII
. A KBART title list for this Collection has been posted to the JSTOR Title Lists
page. Additionally, metadata for ASXIII has been sent to our discovery partners set up to receive this content. Our discovery and linking partners have been notified of this new Collection. Libraries should soon see Arts & Sciences XIII available in their knowledge base management tools for A-Z lists, link resolvers, and discovery indexes.
- JSTOR Participant Linking Partners
List coming soon....
We are continuing in our efforts to make access to the JSTOR archive as convenient as possible for all of our participants. As part of this ongoing work, we are working with various organizations to enable article-level linking into JSTOR from their electronic journals, products, and databases. Institutions that subscribe to these resources may need to contact the providers directly in order to establish or "turn on" links to the JSTOR archive.
- 03/21/2014: Improved Search API (XML Gateway)
JSTOR has recently improved our search API, also known as the JSTOR XML Gateway service, in order to better facilitate metasearching (also known as federated or cross-database searching). Please refer to the Metasearching section in Discovery & Linking for more information. If you are interested in utilizing our new search API, please contact firstname.lastname@example.org.
- 03/17/2014: Title List Available for Hebrew Journals Collection
A KBART title list for the recently launched Hebrew Journals Collection is now available for download on the JSTOR Title Lists Page
. For more information regarding the launch of the Hebrew Journals Collection, please see the press release
- 01/01/2014: New Metadata Delivery Service
JSTOR has developed a new metadata sharing service that will allow us to more flexibly and reliably distribute metadata to our various discovery and linking partners. For more information on receiving metadata for JSTOR content, please see the Metadata Sharing pages in Discovery & Linking.