pub-id-type Type of Publication Identifier

Type of publication identifier, such as a DOI or a publisher’s identifier.

Usage/Remarks

Attribute Best Practice

Type of Identifier

Best Practice is to reserve the @pub-id-type value for the specific type of the external identifier (such as a DOI or PMID) or for a generic type of identifier (such as a publisher’s identifier, an aggregator’s or archive’s identifier, the identifier assigned by an indexing or hosting service, or similar). The values for this attribute are a constrained list (see below) with the attribute @custom-type used as an escape hatch for non-list values.

Authority Identifier

The attribute @assigning-authority should name the organization or system that assigned the identifier or administers the identifier (such as Crossref, OCLC, GenBank, Figshare).

External Identifier Type Not on the List

When a JATS tagger needs to record a value that is not a named value on the list, they should use the value “custom”. This tells a JATS processor that this @pub-id-type is not one of the known types. The attribute @custom-type should then be used to record the type of identifier being named.
For any element with a @pub-id-type attribute that takes the value “custom”, then the @custom-type attribute should be used and should have a value. Schematron or similar can be used to enforce this and, if desired, to constrain the @custom-type values.
Context
The @pub-id-type attribute can be used in several contexts:
  • inside a bibliographic citation element such as <mixed-citation> or <element-citation> (for example, on the <pub-id> element, which identifies a publication cited in a bibliographic reference list);
  • on an object identifier element (<object-id>); and
  • on an issue or volume identifier (for example, on the <issue-id> element, which identifies an issue inside a citation).
Case in Attribute Values
Upper/lower/mixed case in attribute values for organizations and identifier types is likely to be variable and thus unreliable for search/discovery. If possible, JATS recommends a case-insensitive search for such values. For example, if an identifier type is a DOI, many publishers will use “doi” (to keep all attribute values lower case), while others will use “DOI” (because that is the native language acronym). Adding to this variability are identifiers that change over time. Expect to find the organization Crossref in values as “Crossref” (the currently preferred organization name), “CrossRef” (the previously preferred organization name), or “crossref” (for publishers who prefer all lower case for attributes).
Historical Note
Until JATS version 1.2d2 (2018), the @pub-id-type’s value conflated two meanings: the attribute could hold the type of identifier (such as a DOI or ISBN), or it could hold the name of the organization or system that defined or registered the identifier (such as Crossref). There was no way to state both that the identifier content of the element was a DOI and that the server was Figshare or Crossref. Although all the previous @pub-id-type values will continue to be accepted, for Best Practice, the @assigning-authority should name an organization, and the @pub-id-type attribute should describe the identifier type.
OPTIONAL on element: <pub-id>
Value Meaning
accession Generic identifier type for a unique identifier given to an item in a data repository. For example, a DNA or protein sequence record for tracking the sequence record and the associated sequence over time.
archive Generic identifier type for an identifier assigned by an archive or other repository (generally used with elements <object-id>, <issue-id>, and <volume-id>).
ark Archival Resource Key — a Uniform Resource Locator (URL) containing the word “ark” that is a multi-purpose identifier for information objects of any type.
art-access-id Identifier type for a generic article accession identifier used for interchange and retrieval between archives.
arxiv arXiv (archive of electronic preprints) identifier.
coden Obsolete PDB/CCDC identifier (may be present on older articles).
custom Not one of the meanings named in this list. The type can be found as the value of the attribute @custom-type
doaj Identifier of the Directory of Open Access Journals.
doi Digital Object Identifier.
handle Handle identifier, part of the Handle System for assigning, managing, and resolving persistent identifiers for digital objects and other resources on the Internet.
index Generic identifier type for an identifier assigned by an abstracting or indexing service (generally used with elements <object-id>, <issue-id>, and <volume-id>).
isbn International Standard Book Number.
manuscript Generic identifier type for an identifier assigned to a manuscript.
medline NLM Medline identifier.
mr Mathematical Reviews (MR) identifier
other None of the named identifiers in this list. To name the identifier type, use the value “custom” and then the attribute @custom-type rather than this value “other”.
pii The original “Publisher Item Identifier” (PII) was a system to provide unique and concise identification for individual published documents with a highly specified string. The PII specification is no longer in common use (2010).
pmcid PubMed Central identifier.
pmid PubMed Identifier (PubMed ID). See https://www.ncbi.nlm.nih.gov/sites/entrez?db=pubmed.
publisher-id Generic identifier type for a publisher’s identifier, such as an “article-id”, “artnum”, “identifier”, “article-number”, “pub-id”, etc.
sici Serial Item and Contribution Identifier (An ANSI/NISO Z39.56 code to uniquely identify volumes, articles, or other parts of a periodical. A journal article may have more than one SICI, for example, one for a print version and another for an electronic version.)
std-designation The official number of a standard, from a standards body such as ISO, NISO, IEEE, ASME, etc., for example, “Z39.96-2019”.
zbl Zentralblatt MATH (zbMATH) identifier.
Restriction @pub-id-type is an optional attribute; there is no default.
OPTIONAL on elements: <issue-id>, <object-id>, <volume-id>
Value Meaning
accession Generic identifier type for a unique identifier given to an item in a data repository. For example, a DNA or protein sequence record for tracking the sequence record and the associated sequence over time.
archive Generic identifier type for an identifier assigned by an archive or other repository (generally used with elements <object-id>, <issue-id>, and <volume-id>).
ark Archival Resource Key — a Uniform Resource Locator (URL) containing the word “ark” that is a multi-purpose identifier for information objects of any type.
art-access-id Identifier type for a generic article accession identifier used for interchange and retrieval between archives.
arxiv arXiv (archive of electronic preprints) identifier.
coden Obsolete PDB/CCDC identifier (may be present on older articles).
custom Not one of the meanings named in this list. The type can be found as the value of the attribute @custom-type
doaj Identifier of the Directory of Open Access Journals.
doi Digital Object Identifier.
handle Handle identifier, part of the Handle System for assigning, managing, and resolving persistent identifiers for digital objects and other resources on the Internet.
index Generic identifier type for an identifier assigned by an abstracting or indexing service (generally used with elements <object-id>, <issue-id>, and <volume-id>).
isbn International Standard Book Number.
manuscript Generic identifier type for an identifier assigned to a manuscript.
medline NLM Medline identifier.
mr Mathematical Reviews (MR) identifier
other None of the named identifiers in this list. To name the identifier type, use the value “custom” and then the attribute @custom-type rather than this value “other”.
pii The original “Publisher Item Identifier” (PII) was a system to provide unique and concise identification for individual published documents with a highly specified string. The PII specification is no longer in common use (2010).
pmcid PubMed Central identifier.
pmid PubMed Identifier (PubMed ID). See https://www.ncbi.nlm.nih.gov/sites/entrez?db=pubmed.
publisher-id Generic identifier type for a publisher’s identifier, such as an “article-id”, “artnum”, “identifier”, “article-number”, “pub-id”, etc.
sici Serial Item and Contribution Identifier (An ANSI/NISO Z39.56 code to uniquely identify volumes, articles, or other parts of a periodical. A journal article may have more than one SICI, for example, one for a print version and another for an electronic version.)
std-designation The official number of a standard, from a standards body such as ISO, NISO, IEEE, ASME, etc., for example, “Z39.96-2019”.
zbl Zentralblatt MATH (zbMATH) identifier.
Restriction @pub-id-type is an optional attribute; there is no default.
Tagged Samples
Inside a citation for a print journal article, to name the identifier as a DOI
...
<element-citation publication-type="journal" publication-format="print">
 ...
 <fpage>519</fpage>
 <lpage>617</lpage>
 <pub-id pub-id-type="doi">10.1542/peds.2004-1441</pub-id>
</element-citation>
...
Cite a specific print version of an issue
...
<ref>
 <mixed-citation publication-type="journal" publication-format="print">
  <string-name><surname>Ganster</surname>, <given-names>D. C.</given-names></string-name>, 
  <string-name><surname>Schubroeck</surname>, <given-names>J.</given-names></string-name>, 
  <string-name><surname>Sime</surname>, <given-names>W. E.</given-names></string-name>, 
  &amp; <string-name><surname>Mayes</surname>, <given-names>B. T.</given-names></string-name>. 
  <article-title>The nomological validity of the Type A personality among employed 
  adults</article-title> [Monograph]. <source>Journal of Applied Psychology</source>, 
  <year iso-8601-date="1991">1991</year>; <volume>76</volume>(<issue>1</issue>):
  <fpage>143</fpage>-<lpage>168</lpage>. <issue-id assigning-authority="nlm" 
  pub-id-type="call-number">W1 IN249</issue-id>.</mixed-citation>
</ref>
...