Information for Publishers

How to ensure Mendeley Web Importer can read references from your website

Mendeley Web Importer tries to get reference metadata from pages in four ways. 

1. DOI lookup (Recommended)

If the DOI (Digital Object Identifier) of the reference on the page is tagged correctly, Mendeley Web Importer will automatically read it and retrieve metadata for the reference.

We recommended specifying DOIs on your pages using the following META syntax:

<meta name="citation_doi" content="10.1038/nature09108">

2. HTML Meta Elements (Supported)

Sometimes a reference does not have a DOI, so Mendeley Web Importer also supports reading other META elements directly.

For catalog pages, HTML meta elements should be specified in the HTML HEAD section.

There are 5 supported "standards" for describing articles in the META elements:

  • Highwire Press tags (citation_*)
  • bepress tags (bepress_citation_*)
  • Eprints tags (eprints.*)
  • PRISM tags (prism.*)
  • Dublin Core (dc.*/dcterms.*)

Presenting more than one set of tags is not a problem. Use Dublin Core tags only as a last resort because they lack unambiguous fields for journal articles.

Here is an example of how an HTML page may be marked up with META elements:

<meta name="citation_title" content="Global and local fMRI signals driven by neurons defined optogenetically by type and wiring.">
<meta name="citation_authors" content="Lee, Jin Hyung; Durand, Remy; Gradinaru, Viviana; Zhang, Feng; Goshen, Inbal; Kim, Dae-Shik; Fenno, Lief E; Ramakrishnan, Charu; Deisseroth, Karl">
<meta name="citation_journal_title" content="Nature">
<meta name="citation_publisher" content="Nature Publishing Group">
<meta name="citation_issue" content="7299">
<meta name="citation_volume" content="465">
<meta name="citation_doi" content="10.1038/nature09108">
<meta name="citation_firstpage" content="788">
<meta name="citation_lastpage" content="792">
<meta name="citation_date" content="2010">
<meta name="citation_abstract_html_url" content="http://www.mendeley.com/research/global-local-fmri-signals-driven-neurons-defined-optogenetically-type-wiring-1/">
<meta name="citation_abstract_pdf_url" content="http://www.mendeley.com/download/public/3323481/3948897002/a485b448a8aa67f6319355609acbd9f55442ed1d/dl.pdf">

3. Metadata extraction (Fallback)

It is sometimes not possible or feasible to implement HTML META elements for standalone PDF content.

In this case, Mendeley Web Importer will upload the PDF file to its PDF metadata extraction service to identify metadata heuristically. (The uploaded PDF is discarded after processing and not stored on the server.)

It is not possible for this service to operate with 100% accuracy. Providing DOI or HTML META elements specifying metadata is preferred.

4. COinS – ContextObjects in Spans (Legacy)

COinS was a method of making metadata available within <span> elements in HTML, but is now largely unsupported. We are no longer officially supporting COinS, but we retain our legacy COinS parsers within the application as a last resort for legacy compatibility.

Please note that we only currently support the following OpenURL metadata description formats:

  • fmt:kev:mtx:journal
  • fmt:kev:mtx:book
  • fmt:kev:mtx:dissertation
  • fmt:kev:mtx:dc

Both 0.1 and 1.0 OpenURL versions should work, but no assurances is made regarding compatibility.