Documentation

Contributors

This guide gives markup examples of contributor metadata for members registering content by direct deposit of XML. A contributor is a person or organization that is considered the author of a work. A contributor may be a person or a group author (organization in our XML). Contributor metadata also includes affiliations, which have their own guide.

ORCID iDs

An author’s ORCID iD should be included whenever possible. Providing an ORCID iD in a metadata record allows the author’s ORCID record to be automatically updated via our auto-update process. OJS users who have upgraded to version 3.1.2 or later can request authenticated iDs from both contributing authors and co-authors - learn more about the OJS-ORCID plugin.

Contributor roles

We currently support and require a single contributor role per contributor. Supported values are:

  • author
  • editor
  • chair
  • reviewer
  • review-assistant
  • stats-reviewer
  • reviewer-external
  • reader
  • translator

We intend to allow multiple roles per contributor and as expand our list of supported contributor roles in a future update.

Contributor order

The <person_name> and <organization> elements both include required contributor role and sequence attributes. An author may be first or additional. Specific sequence numbering is not allowed, but many systems using our metadata assume that the order of authors as present in the metadata is the appropriate order for metadata display. * If a contributor has just one name, put it under the <surname> field

Note that the data supplied in the <given_name> and <surname> fields is used for display and query matching and must be as accurate as possible.

<person_name sequence="first" contributor_role="author">
  <given_name>Minerva</given_name>
  <surname>Nipperson</surname>
  <ORCID authenticated="true">https://orcid.org/0000-0002-4011-3590</ORCID>
</person_name>

Contributor example

<contributors>
  <person_name sequence="first" contributor_role="author">
    <given_name>Minerva</given_name>
    <surname>Nipperson</surname>
    <suffix>III</suffix>
    <affiliations>
      <institution>
        <institution_id type="ror">https://ror.org/01bj3aw27</institution_id>
        <institution_department>Office of Environmental Management</institution_department>
      </institution>
    </affiliations>
    <institution>
        <institution_name>Tinker Fan Club</institution_name>
        <institution_acronym>TinFC</institution_acronym>
        <institution_place>Boston, MA</institution_place>
        <institution_department>Office of Environmental Management</institution_department>
    </institution>
    <ORCID authenticated="true">https://orcid.org/0000-0002-4011-3590</ORCID>
  </person_name>
  <person_name sequence="additional" contributor_role="author">
    <given_name>Christopher </given_name>
    <surname>Fielding</surname>
    <affiliations>
      <institution>
        <institution_id type="ror">https://ror.org/01bj3aw27</institution_id>
        <institution_department>Office of Environmental Management</institution_department>
      </institution>
    </affiliations>
  </person_name>
  <person_name sequence="additional" contributor_role="author">
    <given_name>Katharine </given_name>
    <surname>Mech</surname>
  </person_name>
</contributors>

Page owner: Patricia Feeney   |   Last updated 2023-October-28