Documentation

Schema deprecation guide

We periodically deprecate older versions of our metadata deposit schema. This guide explains which schema versions are supported going forward and what you need to do to migrate.

Crossref currently supports schema versions 4.3.0 through 5.5.0. As announced in late 2025, all schema versions prior to 5.3.1 will be deprecated by 2028.

Schema to be deprecated

The following versions are scheduled to be deprecated by the end of 2026:

  • crossref4.3.1.xsd
  • crossref4.3.2.xsd
  • crossref4.8.1.xsd
  • doi_resources4.3.2.xsd
  • doi_resources4.3.4.xsd
  • doi_resources4.3.5.xsd
  • doi_resources4.4.2.xsd

These moderately used version will be deprecated by the end of 2027:

  • crossref4.3.3.xsd
  • crossref4.3.4.xsd
  • crossref4.3.5.xsd

ALL remaining pre-5.3.1 versions will be deprecated by the end of 2028:

  • crossref4.3.0.xsd
  • crossref4.3.6.xsd
  • crossref4.3.7.xsd
  • crossref4.4.0.xsd
  • crossref4.4.1.xsd
  • crossref4.4.2.xsd
  • doi_resources4.3.0.xsd
  • doi_resources4.3.6.xsd

For the full, current list of supported schema versions, see Schema versions.

How to migrate

For versions earlier than 5.3.1

Version 5.3.1 introduced a breaking change to affiliations metadata to add support for organisation identifiers (ROR, Wikidata, and ISNI). If you are including affiliations in your metadata you will need to update how affiliations are marked up in your deposits so they validate against the new schema. See the Affiliations and ROR markup guide for details.

Once your affiliations markup is updated, update the schema declaration in your XML to reference the latest supported version crossref5.5.0.xsd.

For 5.3.1 or later

No migration is currently needed, but versions 5.4.0 and 5.5.0 each add new optional metadata that you may want to consider including in your records. Migrating from 5.3.1 to a later supported version requires only a change to your schema declaration and version number in the XML. No changes to your existing markup are needed.

What’s new in each version:

  • 5.4.0: adds a type attribute for citations, support for version numbering, and status support for posted content/preprints. For more details visit the 5.4.0 migration guide.
  • 5.5.0 (current, recommended): adds support for multiple contributor roles per person and the CRediT vocabulary; adds blog and poster as posted content subtypes (and removes report, working paper, and dissertation as posted content subtypes); adds archive locations for posted content. For more details visit the 5.5.0 migration guide.

Page maintainer: Patricia Feeney
Last updated: 2026-August-21