Click here to skip to content

Metadata Store troubleshooting

Here is a list of problems that you may have while using the DataCite Metadata Store (MDS) and how to fix them. Click on a problem to skip to that section.

 

If you are looking for help with a specific error message, search for a part of that message on this page by using the browser search: Ctrl+F (Windows) or Command+F (Mac).

 

Problems minting DOIs using the User Interface (UI)

 

Problems minting DOIs using the API

 

Creating and managing your DOIs

 

Changes to your DataCite account

Problems minting DOIs with the User Interface

For a demonstration of how to use the User Interface to mint and update DOIs, please see the helpful videos on our FAQ page.

General error messages

The user interface will display an error message when it is unable to mint your new DOI. Please see the list of the most likely/common errors below, along with their causes and tips on how you can fix them.

  1. "already exists". You have tried to mint a DOI that already exists in the system. Please give a new DOI to this dataset.
  2. "XML must be uploaded when minting DOIs". You must select the XML document that holds the metadata for your dataset in order to mint the DOI.
  3. "DOI does not match". The DOI given in your metadata does not match the DOI you have given in the form. Please check that you have typed both correctly and try again.
  4. "domain of URL is not allowed". You have tried to give a DOI to a landing page outside of your allowed domain(s). To check your allowed domains, go to ‘My Account’ (top right). To add a new domain to your account, please contact us.
  5. "DOI prefix is not allowed". You have tried to mint a DOI to a prefix that is not allowed on your account. To check which prefix(es) you are allowed to use on your account, go to ‘My Account’ (top right).
  6. "may not be empty". You must give the URL of the landing page that you want the DOI to point to.
  7. "must be a valid URL protocol not allowed". You must enter the full URL, including the 'http://'. Please check you have entered the URL correctly, and try again.
  8. "Handle not exists". If you receive this message while trying to update a DOI it is likely that you have tried to update the DOI too soon after creating it. It takes a few minutes for DOIs to be copied through and recognised in the global registry, and if you try to make changes before that process is finished, you will get an error. Please try to update the DOI again in 10 minutes.
  9. "malformed DOI". The DOI you have tried to mint doesn't have the correct syntax. For more information on how you should form your DOI, see our Information for UK DataCite clients.

Δ Back to top

'xml error:' messages

The XML carrying the metadata for your DOI has to conform to XML standards and specifications given at http://schema.datacite.org. Here is a list of the most likely XML errors and how to resolve them.

  1. xml error: The entity name must immediately follow the '&' in the entity reference.” You have an ampersand in your metadata. Make sure you escape or encode any reserved characters in the body of your metadata. For example, all ampersands in the body of your metadata should be replaced with the text &
  2. xml error: cvc-complex-type.3.2.2: Attribute '[xyz]' is not allowed to appear in element '[abc]'” Check the text in your field tag [xyz], and ensure it is free of typing errors. You may for example have ‘indentifierType’ instead of ‘identifierType’
  3. xml error: cvc-complex-type.2.4.a: Invalid content was found starting with element '[xyz]'. One of '{"http://datacite.org/schema/kernel-2.2":[abc]}' is expected.” This message could be caused by one of two problems. 1. Elements in your metadata may not be in the correct order. Check the ordering of your metadata elements against the order in the example metadata given here: http://schema.datacite.org/. 2. You may have a typing error in your field tag. Check the text in your field tag [xyz] for errors e.g. you may have “titls” instead of “titles”.
  4. xml error: cvc-enumeration-valid: Value '[something]' is not facet-valid with respect to enumeration '[list of allowed terms]'. It must be a value from the enumeration.” You have given a Type element a term that is not from the allowed list. There are 8 fields whose content is restricted to a controlled list. These are: contributorType, dateType, descriptionType, identifierType, resourceTypeGeneral, relatedIdentifierType, relationType and titleType. Please check the metadata schema for the list of allowed terms for these fields.
  5. xml error: cannot find schemaLocation for namespace”. You have declared the wrong schema in the XML header. Please see http://schema.datacite.org for the list of allowed schema.
  6. "xml error: Invalid byte [#] of [#]-byte UTF-8 sequence". This may occur when your metadata contains accented or special characters, e.g. ü, é or º and suggests your XML file has not been properly saved in UTF-8 encoding. Re-save the XML file in UTF-8 and try again.
  7. Property xml threw exception; nested exception is javax.validation.ValidationException: ParseError at [row,col]:[2,6] Message: The processing instruction target matching "[xX][mM][lL]" is not allowed”. You have formatted your XML with spaces between the elements. Recreate your metadata without these and try again.

Δ Back to top

 

 

 

Problems minting DOIs using the API

For errors that you have received while using the API to mint your DOIs, please consult the API documentation at: https://mds.datacite.org/static/apidoc. That page details all the error messages you are likely to receive as a response. If you have problems or error messages not given on that page, please contact tech@datacite.org, CC’ing us here at the British Library: datasets@bl.uk.

Δ Back to top

 

 

 

 

Creating and managing your DOIs

The system is asking me for the DOI: shouldn’t this be automatically generated for me?

No. You need to specify the DOI that you want to assign to the dataset. See the guidelines for creating your suffix here.

Δ Back to top

 

I can’t see the DOI I just minted in DataCite search

There may be two reasons for this. 1. De-selecting the ‘isActive’ flag on a dataset will hide it from DataCite search. View the dataset from within your MDS account and ensure the ‘isActive’ flag is selected. 2. DataCite indexes metadata for search once a day. So it may take up to 24 hours before your dataset is indexed into DataCite search.

Δ Back to top

 

The DOI I just created isn’t resolving

There may be two reasons your DOI is not being resolved. 1. The DOI is not yet live in the Handle system. If this is the case, you should get to a page saying the DOI doesn’t exist. New DOIs may take a couple of minutes to propagate into the system. DOIs that have been updated with a new URL may take a little longer: up to 24 hours. 2. Check that you have entered the correct URL for your DOI. If you have a typing error in the URL, you will either get a 404 message, or be taken to the wrong landing page.

Δ Back to top

 

 

Changes to your DataCite account

I have forgotten my password

If you forget your password, please contact us. We will send you a link that will allow you to reset your password. This link must be used within 24 hours, after which it will expire, and you will need to request a new link from us.

Δ Back to top

 
Back to top Back to top

By using this site, you agree we can set and use cookies. For more details of these cookies and how to disable them, see our cookie policy.