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

Field Descriptions for Form

The following metadata fields are available to create a DOI via the form in Fabrica. Below you will find detailed descriptions of each field and how to use them.

Mandatory Properties

Recommended Properties

Optional Properties

DOI
State Selection
URL
Creators
Title
Publisher
Publication Year
Resource Type General

Subjects
Contributors
Dates
Related Identifiers
Descriptions
Geolocations

Language
Alternate Identifiers
Rights
Sizes
Formats
Version
Funding References

Detailed descriptions of metadata requirements and field examples are included in the documentation for the DataCite Metadata Schema.

For many of the fields, Fabrica will validate the entered information, and that field will subsequently turn green if the information is valid or red if it is not. You will not be able to save until you properly resolve any red fields. In the case of Draft DOIs, which require only the DOI to be saved, you will receive orange warning messages about potential problems instead of red validation errors, so you will not be prevented from saving. If you later update a Draft DOI to a different state, you will need to resolve any resulting red validation errors first.

DOI Field

The DOI field is where you set the DOI you would like to create. This field corresponds to the Identifier field in the DataCite Metadata Schema.

First, select one of the available prefixes from the dropdown box on the left.

A DOI suffix (the part that comes after the prefix) is auto-filled by default. To generate a new DOI name automatically, click the refresh icon on the right side of the DOI name field. Use the x icon on the far right to clear the contents of the DOI name field. You may also type and/or cut and paste your own DOI name into the field manually.

State Selection Field

Use the state selection radio buttons to select a state for the DOI.

Draft DOIs are only visible within DOI Fabrica and can be deleted. Registered DOIs will be made public via registration in the Handle System. Findable DOIs will be registered via the Handle System and will also be included in DataCite search.

Learn more about states

URL Field

Enter the URL of the landing page that the DOI points to.

The URL must be fully formed, as in https://www.datacite.org instead of datacite.org. URLs containing https:// are encouraged.

DOI Fabrica will verify that the URL will resolve. If the URL does resolve, the field will turn green. If it does not resolve, the field will turn red and display an error message. If you don't understand an error message, please contact us.

Creators

The Creators field is where you add the information about the authors of the content. This field is required. You can include up to 25 creators when you create a DOI via the Form.

Auto-populate the Creator

To do this, add a Name Identifier like an ORCID or ISNI in the Name Identifier field. The identifier must be entered as a URL e.g. https://orcid.org/0000-0002-1825-0097. Note: Using this method means the name fields will not be editable to avoid any accidental incorrect attribution.

Manually add the Creator

The type of creator must be selected using the radio buttons. The default type is "Unknown", use this if you don't know the type of Creator. Otherwise select "Person" or "Organization"

  1. Person

To add the name of a person enter the Given Name and Family Name of the Creator in the corresponding fields.

The "Name" field will be constructed automatically from the information entered, but it is not editable. The names are entered like this (instead of using a single name string), so the name can be more appropriately parsed for display by both DataCite services and other services downstream.

The affiliation of the creator can also be included (optional). The organization name is populated by the ROR look-up.

📘

Affiliation

Remember affiliation information included in the DOI metadata will be retrieved via the affiliation facet in DataCite Search.

Multiple creators can be included by clicking on the "Add another creator" button.

  1. Organization

To add an organization as the creator select "Organization" using the radio button and type the name in the field below.

Organizations can also have affiliations, for example if the main organization is a project or working group, rather than a formal organization.

You can add multiple affiliations.

Title

The Title field is a required field. You can add the information in one of two ways.

  1. To include the main title of the content, add it into the Title field and save.
  1. If the title is not the main title of the content, use the Title Type field and select the appropriate option from the drop down menu.

There is the option to select the language from the drop down menu and also to include another title by clicking "Add another title".

Publisher

Enter the name of the entity that holds, publishes, archives, issues, or produces the resource. This field is used to form the citation for the dataset, so consider which entity would be most appropriate. The information in this field does not need to match that of the repository account holding the DOIs in Fabrica.

Publication Year

Enter the year when the resource was or will be made publicly available. The field accepts a valid year entry between 1450 and next year, with a rolling window for each subsequent year.

Resource Type General

The general type of the resource. This is a controlled list as specified in the DataCite Metadata Schema.

In the Resource Type subfield include a short free-text description of the resource type.

Subjects

In the Subjects field add the subject, keyword, classification code, or key phrase describing the resource. Use the drop down menu to select from the OECD Fields of Science.

When you select from the OECD list, the Subject Scheme and Subject Scheme URI will be auto-populated.

If the subject name does appear in the drop down OCED menu, type the name of the subject and press enter. Optionally add the Subject Scheme and Subject Scheme URI if available.

Contributors

A contributor is an institution or person responsible for collecting, managing, distributing, or otherwise contributing to the development of the resource. Select the Contributor Type from the drop down menu.

As with the Creator field, the type of contributor should be indicated using the radio buttons, slect "Person", "Organization" or "Unknown". If the contributor is a person then add the name, either by entering a Name Identifier, like an ORCID, as shown below, or by typing the Given Name and Family Name into the corresponding fields.

If the contributor is an organization, type the name into the Name field.

Finally, the affiliation of the contributor can be optionally added.

Dates

The Dates field is where any dates relevant to the content can be added. The following formats are accepted:

Date:
YYYY
YYYY-MM-DD
YYYYMM-DDThh:mm:ssTZD (or any other format or level of granularity described in
W3CDTF)

Date ranges:
2004-03-02/2005-06-02 (RKMSISO8601 standard for depicting date ranges)

Years before 0000 must be prefixed with a - sign, e.g. -0054 to indicate 55 BC.

Then select the Date Type from the drop down list.

Specific information about the date can be added if appropriate. This is a free text field and may be used to provide more information about the publication, release or collection date details. It may also be used to clarify dates in ancient history for example: 55 BC, 55BCE.

Another date can be added by clicking on the "add another date" button.

Related Identifiers

Use the Related Identifiers field to add information about related resources. These must be globally unique identifiers. You can view the full list of supported unique identifiers here. When the identifier is entered, the Related Identifier Type is auto-populated, in the example below, a DOI.

Then select the Relation Type from the drop down menu. The full controlled vocabulary of relationTypes with descriptions can be found in the appendix of the DataCite metadata schema documentation here. More information about Relation Types can be found here.

Finally, the Resource Type General of the related identifier can be included. This is optional.

Descriptions

The Description field is free text field and includes any additional information.

Description Type

The Description Type can optionally be added underneath the description text from the drop down menu e.g Abstract.

Description Type also includes the SeriesInformation option. To encourage consistent data entry between clients, the form validates series information according to the DataCite-preferred way of parsing the entered information. You will receive an orange warning message if the series information does not conform, but you will not be prevented from saving.

The help text below the description field provides information about the correct format:

Enter series information in the recommended format of series title, followed by comma and optional volume(issue), firstpage-lastpage

There is an option to choose a language for the description and you can include multiple descriptions by clicking " Add another description".

Geolocations

The Geolocations field describes a spatial region or named place where the data was gathered or about which the resource is focused.

The example below includes a Geolocation Box. A box is defined by two geographic points. Left low corner and right upper corner. Each point is defined by its longitude and latitude. More information about Geolocation Box metadata field is available here

Language

Include the primary language of the resource being shared by selecting from the drop-down list of languages.

Alternate Identifiers

An Alternate Identifier is an identifier, other than the primary identifier, in this case a DOI. It can be any alphanumeric string which is unique within its domain of issue. This field could be used for, for example, local identifiers. Alternate Identifier should be used as another identifier of the same instance (same location, same file).

In the example below, the Alternate Identifier is a PMID. Select the Alternate Identifier Type from the drop down list as shown below.

If the Alternate Identifier Type does not appear in the list, add it by typing it into the field and click enter.

Rights

This metadata field can be used to add any rights information for this resource. The property may be repeated to record complex rights characteristics. Start by selecting from the standard licenses. If the license does not appear in the list, type it into the field and click enter.

Once the Rights license is selected from the list, the Rights URI field will be auto-populated. Alternatively add this information manually if a new license type is being added.

Sizes

Add the Size of the resource in this field if applicable. Sizes can be included as, for example, bytes, pages, inches or duration (extent), for example, hours, minutes, days.

Formats

This field describes the technical format of the resource. This is a free text field, in the example below the format is PDF.

Version

This field is for including the version number of the resource. The Version field is used for minor version changes only. Register a new identifier for a major version change. Individual stewards need to determine which are major vs. minor versions. Based on the work of the Earth Science Information Partners (ESIP). More guidance here.

Funding References

The Funding References field is for including information about financial support (funding) for the resource being registered.

Start by selecting the Funder Name. If the name does not appear in the list, add it by typing it into the field and then click enter.

The Funder Identifier and Funder Identifier Type are auto-populated when the Funder Name is selected from the look up. Alternatively, add this information into the corresponding fields.

Add the code assigned by the funder to a sponsored award (grant) in the Award Number field. Then include the Award Title and the Award URI in the appropriate fields as shown below.

📘

Would you like to know more?

If you have any questions, requests or ideas please contact us.

Updated 2 months ago


Field Descriptions for Form


Suggested Edits are limited on API Reference Pages

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