We support deposit of funding and license metadata in .csv format. Deposits are made via the web deposit form. To submit, select the Supplemental Metadata Upload option under data type to upload the file. Enter your login details and email address, then submit. The .csv metadata will be converted to XML and submitted to the Crossref System.
Similarity Check participants may also upload as-crawled URLs as a .csv file.
Troubleshooting uploads
Some basic validation is performed upon upload. Incomplete or incorrect files will return an error message and will not be deposited. If the file passes the initial validation it will be converted to XML and submitted to the Crossref system. You will receive a submission log when your deposit is complete. Please review the log to be sure the DOIs have been updated. The initial validation addresses .csv formatting issues only, additional validation is performed upon deposit.
As-crawled URLs for Similarity Check indexing may also be submitted by CSV upload.
Please send questions or comments to support@crossref.org. If you are reporting problems with an upload please attach the .csv file to your support request.
CSV specifications
Files submitted via .csv upload must comply with these specifications:
- Column headings must match the headings outlined for each deposit type. You may include funding metadata, license metadata, or both funding and license metadata.
- Values must be separated by a comma.
- Commas and quotation marks must not appear within a column value.
- All dates must be in YYYY-MM-DD format.
- If metadata is not available for an item the table cell should be left blank. If an entire column is not populated it may be omitted. Do not enter placeholders such as n/a or -, this will cause your deposit to fail or cause incorrect metadata to be attached to a DOI.
- Files may be up to 45 MB. Note that we will split the file into batches of 5,000 DOIs each for processing, and we'll send you 2 emails for each batch (a submission log and a copy of the submitted XML) .
Sample files are available at the bottom of this page.
Funding metadata: the .csv file must contain 4 columns with these headings:
- DOI: the DOI being augmented
- <funder_name>: name of the funding agency as it appears in the Open Funder Registry
- <funder_identifier>: funding agency identifier in the form of a DOI
- <award_number>: grant number or other fund identifier
If a DOI has multiple funders, the DOI must be repeated for each funder. It is recommended that all available metadata is deposited. If a piece of funding metadata is not available (a grant number, for example) the field should be left blank.
License metadata: Members may deposit license metadata to support text and data mining. The .csv file may contain these headings:
- DOI: the DOI being augmented (required)
- <license_ref applies_to="vor">: license URL for version of record (optional)
- <vor_lic_start_date>: start date of version of record license (optional)
- <license_ref applies_to="am">: license URL for accepted manuscript (optional)
- <am_lic_start_date>: start date of accepted manuscript license (optional)
- <license_ref applies_to="tdm">: license URL for accepted manuscript (optional)
- <tdm_lic_start_date>: start date of accepted manuscript license (optional)
- <resource content_version="vor">: item URL for version of record (optional)
- <resource content_version="vor" mime_type="?">: item URL for version of record with MIME type (optional)
- <resource content_version="am">: item URL for author manuscript with MIME type (optional)
- <resource content_version="am" mime_type="?">: item URL for author manuscript with MIME type (optional)
- <resource>: item URL with no version type and with MIME type (optional)
- <resource mime_type="?">: item URL with no version type (optional)
where "?" is the MIME type as defined in the Crossref deposit schema
Funding and license metadata: funding and license metadata may be combined into a single file. Order is important, please include columns in the order listed below:
- DOI: the DOI being augmented
- <funder_name>: name of the funding agency as it appears in the Open Funder Registry
- <funder_identifier>: funding agency identifier in the form of a DOI
- <award_number>: grant number or other fund identifier
- <license_ref>: license URL (optional)
- <license_ref applies_to="vor">: license URL for version of record (optional)
- <vor_lic_start_date>: start date of version of record license (optional)
- <license_ref applies_to="am">: license URL for accepted manuscript (optional)
- <am_lic_start_date>: start date of accepted manuscript license (optional)
- <license_ref applies_to="tdm">: license URL for accepted manuscript (optional)
- <tdm_lic_start_date>: start date of accepted manuscript license (optional)
- <resource content_version="vor">: item URL for version of record (optional)
- <resource content_version="vor" mime_type="?">: item URL for version of record with MIME type (optional)
- <resource content_version="am">: item URL for author manuscript with MIME type (optional)
- <resource content_version="am" mime_type="?">: item URL for author manuscript with MIME type (optional)
where "?" is the MIME type as defined in the Crossref deposit schema
Sample .csv files
Comments
0 comments
Please sign in to leave a comment.