5 contributor

Definition: a metadata schema block containing a contributor to a RAiD and their associated properties

Requirement: at least one contributor is mandatory

Occurrence: 1-n

Example JSON

5.1 contributor.id

Definition: the contributor (person) associated with a project or activity identified by a persistent identifier (PID)

Requirement: mandatory for each contributor supplied

Occurrence: 1-n

Allowed values: identifier defined by contributor.schemaUri

5.2 contributor.schemaUri

Definition: the URI of the contributor identifier schema

Requirement: mandatory for each contributor supplied

Occurrence: 1

Allowed values: closed controlled list defined at https://vocabulary.raid.org/contributor.schemaUri/215

  • https://orcid.org/ (ORCID)

  • https://isni.org/ (ISNI)

Constraints: a PID is required and (currently) only ORCID and ISNI are allowed

Note: The controlled list of allowed identifier schemas is defined at https://vocabulary.raid.org/contributor.schemaUri/215 and is shared across all Registration Agencies.

5.3 contributor.position

Definition: a metadata schema sub-block describing a contributor’s administrative position on a project or activity

Requirement: mandatory for each contributor supplied

Occurrence: 1

Constraints: contributors must have one and only one position at any given time (contributors may also be flagged as a ‘leader’ or ‘contact’ separately)

Note: This property represents a contributor’s administrative position on a project (such as their position on a grant application); use contributor.role to define for scientific or scholarly contribution.

5.3.1 contributor.position.id

Definition: a contributor’s administrative position in the project

Requirement: mandatory for each contributor.position supplied

Occurrence: 1

Allowed values: closed controlled list derived from contributor.position.schemaUri

  • https://vocabulary.raid.org/contributor.position.schema/307 (Principal or Chief Investigator)

  • https://vocabulary.raid.org/contributor.position.schema/308 (Co-investigator or Collaborator)

  • https://vocabulary.raid.org/contributor.position.schema/309 (Partner Investigator, e.g., industry, government, or community collaborator)

  • https://vocabulary.raid.org/contributor.position.schema/310 (Consultant, e.g., someone hired as a contract researcher by the project)

  • https://vocabulary.raid.org/contributor.position.schema/311 (Other Participant not covered by one of the positions above, e.g., ‘member’ or ‘other significant contributor’)

Default: contributor.position.id for first-entered contributor (only) defaults to ‘Principal or Chief Investigator’

5.3.2 contributor.position.schemaUri

Definition: the URI of the position schema used

Requirement: mandatory for each contributor.position supplied

Occurrence: 1

Allowed values: closed controlled list defined at https://vocabulary.raid.org/contributor.position.schemaUri/277

  • https://vocabulary.raid.org/contributor.position.schema/305

Note: Controlled list informed by Simon Cox’s Project Ontology, OpenAIRE ‘Project’ guidelines, NIH definitions, ARC definitions, and DataCite Metadata Schema 4.4 Appendix 1 Table 5 ‘Description of contributorType’.

5.3.3 contributor.position.startDate

Definition: date the contributor began position associated with the project or activity

Requirement: mandatory for each contributor.position supplied

Occurrence: 1

Allowed values: ISO 8601 standard date

Default: date record created

Format: YYYY-MM-DD

Examples: 2025-08-28; 2025-08; 2025

Note: Only year is required, month and day are optional (but recommended when available).

5.3.4 contributor.position.endDate

Definition: date the contributor terminated position associated with the project or activity

Requirement: recommended if the contributor has left the project

Occurrence: 0-1

Allowed values: ISO 8601 standard date

Format: YYYY-MM-DD

Examples: 2025-08-28; 2025-08; 2025

Note: Only year is required, month and day are optional (but recommended when available).

5.4 contributor.leader

Definition: flag indicating that the contributor as a project leader

Requirement: at least one contributor must be flagged as a project leader

Occurrence: 0-1

Allowed values:

  • Yes

  • Null

Note: More than one contributor can be flagged as a leader if the project is jointly led.

5.5 contributor.contact

Definition: flag indicating that the contributor as a project contact

Requirement: at least one contributor must be flagged as a project contact

Occurrence: 0-1

Allowed values:

  • Yes

  • Null

Note: More than one contributor can be flagged as a contact.

5.6 contributor.role

Definition: metadata schema sub-block describing a contributor’s scientific or scholarly role on a project using the CRediT vocabulary

Requirement: recommended

Occurrence: 0-n

Note: Changes to roles are tracked through version history rather than explicitly declared.

5.6.1 contributor.role.id

Definition: a contributor’s (person) role(s) on the Project

Requirement: mandatory for each contributor.role provided

Occurrence: 0-1

Allowed values: closed controlled list derived from contributor.role.schemaUri

  • https://credit.niso.org/contributor-role/conceptualization/

  • https://credit.niso.org/contributor-role/data-curation/

  • https://credit.niso.org/contributor-role/formal-analysis/

  • https://credit.niso.org/contributor-role/funding-acquisition/

  • https://credit.niso.org/contributor-role/investigation/

  • https://credit.niso.org/contributor-role/methodology/

  • https://credit.niso.org/contributor-role/project-administration/

  • https://credit.niso.org/contributor-role/resources/

  • https://credit.niso.org/contributor-role/software/

  • https://credit.niso.org/contributor-role/supervision/

  • https://credit.niso.org/contributor-role/validation/

  • https://credit.niso.org/contributor-role/visualization/

  • https://credit.niso.org/contributor-role/writing-original-draft/

  • https://credit.niso.org/contributor-role/writing-review-editing/

5.6.2 contributor.role.schemaUri

Definition: the URI of the role schema used

Requirement: mandatory for each contributor.role provided

Occurrence: 0-1

Allowed values: closed controlled list defined at https://vocabulary.raid.org/contributor.role.schemaUri/165

  • https://credit.niso.org/

Constraints: currently limited to the CRediT vocabulary