DataCite Support

DataCite Support

Welcome to DataCite's support site. Here you will find helpful information about our services. We have included comprehensive technical guides, training materials, and tips to help you successfully use DataCite services.

Get Started    API Reference

DataCite Metadata Schema v4.2 Properties Overview

Overview

The properties of the DataCite Metadata Schema are presented in this section. More detailed descriptions of the properties, and their related sub-properties, are provided in DataCite Schema Mandatory Properties and DataCite Schema Recommended and Optional Metadata.

There are three different levels of obligation for the metadata properties:

  • Mandatory (M) properties must be provided,
  • Recommended (R) properties are optional, but strongly recommended for interoperability
  • Optional (O) properties are optional and provide richer description.

Those clients who wish to enhance the prospects that their metadata will be found, cited and linked to original research are strongly encouraged to submit the Recommended as well as Mandatory set of properties. Together, the Mandatory and Recommended set of properties and their sub-properties are especially valuable to information seekers and added-service providers, such as indexers. The Metadata Working Group members strongly urge the inclusion of metadata identified as Recommended for the purpose of achieving greater exposure for the resource’s metadata record, and therefore, the underlying research itself.

The properties listed in Table 1 have the obligation level Mandatory, and must be supplied when submitting DataCite metadata. The properties listed in Table 2 have one of the obligation levels Recommended or Optional, and may be supplied when submitting DataCite metadata.

The prospect that a resource's metadata will be found, cited and linked is enhanced by using the combined Mandatory and Recommended "super set" of properties and sub-properties. Those properties recommended by discovery are so indicated by a callout box like this:

👍

Recommended for discovery

(Further notes about the property appear here, as necessary.)

Of the Recommended set of properties, the most important to use is the Description property, together with the Recommended sub-properties descriptionType ="Abstract" (see DataCite Properties and property 17). The detailed information about the Description property includes descriptions of controlled list values, indicating those values that are especially important for information seekers and added-service providers. It cannot be emphasized enough how valuable an Abstract is to other scholars in finding the resource and then determining whether or not the resource, once found, is worth investigating further, re-using or validating.

Table 1: DataCite Mandatory Properties

ID

Property

Obligation

1

Identifier (with mandatory type sub-property)

M

2

Creator (with optional name identifier and affiliation sub-properties)

M

3

Title (with optional type sub-properties)

M

4

Publisher

M

5

PublicationYear

M

10

ResourceType (with mandatory general type description sub-property)

M

Table 2: DataCite Recommended and Optional Properties

ID

Property

Obligation

6

Subject (with scheme sub-property)

R

7

Contributor (with type, name identifier, and affiliation sub-properties)

R

8

Date (with type sub-property)

R

9

Language

O

11

AlternateIdentifier (with type sub-property)

O

12

RelatedIdentifier (with type and relation type sub-properties)

R

13

Size

O

14

Format

O

15

Version

O

16

Rights

O

17

Description (with type sub-property)

R

18

GeoLocation (with point, box and polygon sub-properties)

R

19

FundingReference (with name, identifier, and award related sub-properties)

O

Citation

Because many users of this schema are members of a variety of academic disciplines, DataCite remains discipline-agnostic concerning matters pertaining to academic style sheet requirements. Therefore, DataCite encourages rather than requires a particular citation format(2). In keeping with this approach, the following is the preferred format for rendering a DataCite citation for human readers using the mandatory properties of the schema:

Creator (PublicationYear): Title. Publisher. Identifier 

It may also be desirable to include information from optional properties, such as Version. This is particularly important to include when citing software. For example:

Creator (PublicationYear): Title. Version. Publisher. (resourceTypeGeneral). Identifier

For citation purposes, DataCite prefers that DOI names are displayed as linkable, permanent URLs, for example, "https://doi.org/10.1234/abc"; however, the Identifier may appear in its original format. If the original format is chosen, be sure to include the characters “doi:" pre-pended to the Identifier as in “doi:10.1234/abc.”

For resources that do not have a standard publication year value, DataCite suggests that PublicationYear should include the date that is preferred for use in a citation.

Here are several examples:

A special note regarding citation of dynamic datasets

For datasets that are continuously and rapidly updated, there are special challenges both in citation and preservation. For citation, four approaches are possible:

a) Cite a specific slice(3) or subset (the set of updates to the dataset made during a particular period of time or to a particular area of the dataset); Example: Data Request T.Jansen; SAHFOS; Work published 2014 via SAHFOS ; Area Def: 54-65°N, 0-45°W. Temporal Def: 1980-2012 (April-August) Taxonomic Def: All zooplankton; (dataset). https://doi.org/10.7487/2014.15.1.1

b) Cite a specific snap-shot(1) (a copy of the entire dataset made at a specific time); Example: König-Langlo, G., & Sieger, R. (2010). BSRN snapshot 2010-01 as ISO image file (3.75 GB) [Data set]. PANGAEA - Data Publisher for Earth & Environmental Science. (dataset). https://doi.org/10.1594/pangaea.833424

c) Cite the continuously updated dataset(1), but add an Access Date and Time to the citation. Example: Doe, J. and R. Roe. 2001. The FOO Data Set. Version 2.3. The FOO Data Center. (dataset). https://doi.org/10.xxxx/notfoo.547983. Accessed 1 May 2011.

d) Cite a query(4), time-stamped for re-execution against a versioned database. The RDA recommended citation for this approach is: R. Roe. 2017. "The Moo Data Query" created at 2017-07-21 10:25:30 PID https://doi.org/10.xxxx/notmoo.857988. Subset of Moo Database (dataset). PID https://doi.org/10.xxxx/bigmoo.360873.

Notes:
The "slice," and "snap-shot" and "query" options require unique identifiers. Be aware that the third option (c) necessarily means that following the citation does not result in access to the resource as cited. This limits reproducibility of the work that uses this form of citation. In addition, please note that access date and time may be combined with the first (a), second (b) and fourth (d) options, but it must be used with the third option (c).

The fourth option (d) may shift more work onto repositories to store database versions for all the queries, so not all repositories will be able to support this alternative.

DataCite Properties

The DataCite Schema Mandatory Properties provides a detailed description of the mandatory properties, which must be supplied with any initial metadata submission to DataCite, together with their sub-properties. If one of the required properties is unavailable , please use one of the standard (machine-recognizable) codes listed in Standard Values for Unknown Information. In DataCite Schema Recommended and Optional Properties, the Recommended and Optional properties are described in detail. For an example of how to make a submission in XML format, please see the XML Metadata Examples or the DataCite Metadata Schema website.

Throughout this document, a naming convention has been used for all properties and sub-properties as follows: properties begin with a capital letter, whereas sub-properties begin with a lower case letter. If the name is a compound of more than one word, subsequent words begin with capital letters. This convention is known as “camelCase.”

As indicated previously, this documentation uses a callout box to identify the combined Mandatory and Recommended "super set" of properties and sub-properties that enhance the prospect that the resource's metadata will be found, cited and linked.

For each property, the Occurrence field indicates cardinality/quantity constraints for the properties as follows:

0-n = optional and repeatable
0-1 = optional, but not repeatable
1-n = required and repeatable
1 = required, but not repeatable

NOTE:
XML provides an xml:lang attribute that can be used on the properties Title, Subject and Description, and also on the properties Creator, Contributor and Publisher for organizational names. The allowed values are IETF BCP 47, ISO 639-1 language codes, e.g. en, de, fr. This provides a way to describe the language used for the content of the specified properties. The schema provides a Language property to be used to describe the language of the resource.

XML Examples

Examples for various resource types and special cases can be found in XML Metadata Examples.

XML Schema

The XML Schema is available here: http://schema.datacite.org/meta/kernel-4.1/metadata.xsd

Citation:

DataCite Metadata Working Group. (2017). DataCite Metadata Schema for the Publication and Citation of Research Data. Version 4.1. DataCite e.V. http://doi.org/10.5438/0015

Note that the schema and the documentation will always have the same version number.

Each subsequent version of the schema will be at the same location using an address composed in the same manner, that is: http://schema.datacite.org/meta/kernel-versionnumber/metadata.xsd.

Earlier versions will continue to be available at their previous locations for backward compatibility.

Notes

  1. For more information on DCMI SAM, see http://wiki.dublincore.org/index.php/DCMI_Science_And_Metadata.
  2. In collaboration with CrossRef, DataCite has created a DOI Citation Formatter Service available at http://crosscite.org/citeproc/. The user can choose from more than 500 different citation formats in 45 different languages.
  3. Ball, A. & Duke, M. (2015, July 30). ‘How to Cite Datasets and Link to Publications’. DCC How-to Guides. Edinburgh : Digital Curation Centre. Retrieved April 13, 2017, from: http://www.dcc.ac.uk/resources/how-guides/cite- datasets#sec:versions
  4. Rauber, A., Uytvanck, D. V., Asmi, A., & Proll, S. (2016, February 09). Identification of Reproducible Subsets for Data Citation, Sharing and Re-Use. Retrieved April 13, 2017, from https://www.rd- alliance.org/system/files/documents/TCDL-RDA-Guidelines_160411.pdf
  5. Smith AM, Katz DS, Niemeyer KE, FORCE11 Software Citation Working Group. (2016) Software citation principles. PeerJ Computer Science 2:e86 https://doi.org/10.7717/peerj-cs.86

Updated 10 months ago

DataCite Metadata Schema v4.2 Properties Overview


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.