Latest blog posts
Patricia Feeney
2025 March 19

Version 5.4.0 metadata schema update now available

This year, metadata development is one of our key priorities and we’re making a start with the release of version 5.4.0 of our input schema with some long-awaited changes. This is the first in what will be a series of metadata schema updates.

What is in this update?

Publication typing for citations

This is fairly simple; we’ve added a ‘type’ attribute to the citations members supply. This means you can identify a journal article citation as a journal article, but more importantly, you can identify a dataset, software, blog post, or other citation that may not have an identifier assigned to it. This makes it easier for the many thousands of metadata users to connect these citations to identifiers. We know many publishers, particularly journal publishers, do collect this information already and will consider making this change to deposit citation types with their records.

...Find out more
Martyn Rittman
2025 March 12

2025 public data file now available

Every year we release metadata for the full corpus of records registered with us, which can be downloaded for free in a single compressed file. This is one way in which we fulfil our mission to make metadata freely and widely available. By including the metadata of over 165 million research outputs from over 20,000 members worldwide and making them available in a standard format, we streamline access to metadata about scholarly objects such as journal articles, books, conference papers, preprints, research grants, standards, datasets, reports, blogs, and more.

...Find out more
Patricia Feeney
2025 March 05

Come ROR with us: Using ROR IDs in place of Funder IDs

Today, we’re delighted to let you know that Crossref members can now use ROR IDs to identify funders in any place where you currently use Funder IDs in your metadata. Funder IDs remain available, but this change allows publishers, service providers, and funders to streamline workflows and introduce efficiencies by using a single open identifier for both researcher affiliations and funding organizations.

As you probably know, the Research Organization Registry (ROR) is a global, community-led, carefully curated registry of open persistent identifiers for research organisations, including funding organisations. It’s a joint initiative led by the California Digital Library, Datacite and Crossref launched in 2019 that fulfills the long-standing need for an open organisation identifier.

...Find out more
Susan Collins
2025 February 27

The GEM program - Year Two 2024

We began our Global Equitable Membership (GEM) Program to provide greater membership equitability and accessibility to organizations in the world’s least economically advantaged countries. Eligibility for the program is based on a member’s country; our list of countries is predominantly based on the International Development Association (IDA). Eligible members pay no membership or content registration fees. The list undergoes periodic reviews, as countries may be added or removed over time as economic situations change.

...Find out more
  • Menu
search

Documentation

Pending publications markup guide

Peer reviews markup guidePosted content (includes preprints) markup guide

This guide gives markup examples for members registering pending publications by direct deposit of XML. It is not currently possible to register the pending publications record type using one of our helper tools.

How to make changes to records

How to update records - for Crossmark users

Crossmark service users can add the withdrawal to the Crossmark metadata as a scholarly update assertion (using the update type withdrawal). Update the landing page by updating the metadata record you provide us, using the same DOI in the assertion. See example of a full deposit for an XML example. If you choose, you can publish a separate update, and then link to the new DOI in the Crossmark metadata.

The green banner saying Manuscript has been accepted will change to a red banner saying Accepted manuscript has been withdrawn. See the following withdrawn pending publication example landing page with its associated metadata deposit.

How to update records - for non Crossmark users

Our system will not be able to identify your pending publication as withdrawn, which means the green Manuscript has been accepted banner will remain on the landing page. Therefore it is critical that you write a clear statement about the withdrawal in the Intent to Publish statement. The Intent to Publish statement is supplied in the XML element - see the default Intent to publish statement message below.

Customizations

You can personalize the display of the Crossref-hosted landing page with the following information:

  • member/society/journal logo
  • custom wording for the intent to publish statement
  • display of all provided optional extra metadata such as article title, funder identifiers, ORCID iDs, license information
  • Crossmark to handle the rare occasions when a member rescinds acceptance.

If you’d like to display a custom logo on your pending publication landing page, please email us the logo, and include your member name, prefix, and a note indicating that the logo is to be used for pending publication. We accept both JPEG and PNG files (dimensions should be 112px by 112px).

Intent to publish statement

This is the default intent to publish statement shown on the landing page:

This paper has been accepted for publication so its publisher has pre-registered a Crossref DOI. This persistent identifier and link [DOI INSERTED HERE] can already be shared by authors and readers, as it will redirect to the published article when available.

We encourage you to provide your own custom statement in the metadata which will replace the default statement.

The intent to publish statement can be used to convey any information you’d like to share about the forthcoming publication event (such as process, timeline). In the event that you delay publication or withdraw the publication, this statement may be very informative for your community - both the readers on your platform as well as the systems that consume Crossref metadata.

Metadata reference examples for pending publication

Here are three examples of pending publication records. The full record contains the full range of metadata accepted for pending publication. The basic record has the bare minimum metadata required. The withdrawn record is for a pending publication that the member has decided not to publish.

DOIDescriptionLinks
FullThis record contains the full range of metadata accepted for a pending publication.Deposit XML, XML API
BasicThis basic record contains only the required metadata for a pending publication. We apply the default Intent to Publish statement in the absence of a custom message. Here, some authors have ORCID iDs with affiliation data; others do not.Deposit XML, XML API
WithdrawnIn this record of a withdrawn pending publication, the member has registered a pending publication and then updated the record to reflect the withdrawal. This example is an in situ scholarly update with no separate update published.Deposit XML, XML API

Example of a full deposit 

<doi_batch xmlns="http://www.crossref.org/schema/4.4.2"
    xmlns:fr="http://www.crossref.org/fundref.xsd" xmlns:jats="http://www.ncbi.nlm.nih.gov/JATS1"
    xmlns:mml="http://www.w3.org/1998/Math/MathML"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4.4.2"
    xsi:schemaLocation="http://www.crossref.org/schema/4.4.2 https://www.crossref.org/schemas/crossref4.4.2.xsd">
    <head>
        <doi_batch_id>org.crossref.early.001</doi_batch_id>
        <timestamp>000001</timestamp>
        <depositor>
            <depositor_name>Crossref</depositor_name>
            <email_address>support@crossref.org</email_address>
        </depositor>
        <registrant>Crossref</registrant>
    </head>
    <body>
        <pending_publication>
            <contributors>
                <person_name sequence="first" contributor_role="author">
                    <given_name>Josiah</given_name>
                    <surname>Carberry</surname>
                    <ORCID>https://orcid.org/0000-0002-1825-0097</ORCID>
                </person_name>
                <person_name sequence="additional" contributor_role="author">
                    <given_name>Megan</given_name>
                    <surname>Strongjackplum</surname>
                    <affiliation>University of Los Angeles</affiliation>
                </person_name>
                <person_name sequence="additional" contributor_role="author">
                    <given_name>Sonder</given_name>
                    <surname>Meander</surname>
                </person_name>
                <person_name sequence="additional" contributor_role="editor">
                    <given_name>Matt</given_name>
                    <surname>Techthespian</surname>
                    <affiliation>New York Institute of Technology</affiliation>
                </person_name>
            </contributors>
            <publication>
                <full_title>Journal of Psychoceramics</full_title>
                <doi>10.5555/1234567890</doi>
            </publication>
            <titles>
                <title>Processing Fragmented Postmodernity: Cake for the Disenchanted</title>
            </titles>
            <acceptance_date>
                <month>07</month>
                <day>27</day>
                <year>2018</year>
            </acceptance_date>
            <intent_statement> This article has been peer reviewed and accepted for publication by
                Crossref University Press. It is slated to publish on Dec 11.</intent_statement>
            <fr:program xmlns:fr="http://www.crossref.org/fundref.xsd" name="fundref">
                <fr:assertion name="fundgroup">
                    <fr:assertion name="funder_name"> National Science Foundation <fr:assertion
                            name="funder_identifier"
                            >https://doi.org/10.13039/100000001</fr:assertion>
                    </fr:assertion>
                    <fr:assertion name="award_number">CNS-1228930</fr:assertion>
                    <fr:assertion name="award_number">CNS-2345567</fr:assertion>
                </fr:assertion>
                <fr:assertion name="fundgroup">
                    <fr:assertion name="funder_name"> Eva Crane Trust <fr:assertion
                            name="funder_identifier">10.13039/100012660</fr:assertion>
                    </fr:assertion>
                    <fr:assertion name="award_number">ECTA20160303</fr:assertion>
                    <fr:assertion name="award_number">ECTA30498</fr:assertion>
                </fr:assertion>
                <fr:assertion name="fundgroup">
                    <fr:assertion name="funder_name">Financial Authority</fr:assertion>
                </fr:assertion>
                <fr:assertion name="fundgroup">
                    <fr:assertion name="funder_name">Federal Wilderness Commission</fr:assertion>
                </fr:assertion>
                <fr:assertion name="fundgroup">
                    <fr:assertion name="funder_name">Foundation of Minor Health</fr:assertion>
                    <fr:assertion name="award_number">MED00001234</fr:assertion>
                </fr:assertion>
            </fr:program>
            <program xmlns="http://www.crossref.org/AccessIndicators.xsd" name="AccessIndicators">
                <license_ref applies_to="vor" start_date="2018-12-11"
                    >http://psychoceramics.labs.crossref.org/</license_ref>
            </program>
            <doi>10.5555/pending-publication-multi-author-funder-test</doi>
        </pending_publication>
    </body>
</doi_batch>

Example of a basic deposit 

<doi_batch xmlns="http://www.crossref.org/schema/4.4.2"
    xmlns:fr="http://www.crossref.org/fundref.xsd" xmlns:jats="http://www.ncbi.nlm.nih.gov/JATS1"
    xmlns:mml="http://www.w3.org/1998/Math/MathML"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4.4.2"
    xsi:schemaLocation="http://www.crossref.org/schema/4.4.2 https://www.crossref.org/schemas/crossref4.4.2.xsd">
    <head>
        <doi_batch_id>org.crossref.early.001</doi_batch_id>
        <timestamp>000002</timestamp>
        <depositor>
            <depositor_name>Crossref</depositor_name>
            <email_address>support@crossref.org</email_address>
        </depositor>
        <registrant>Crossref</registrant>
    </head>
    <body>
        <pending_publication>
            <contributors>
                <person_name sequence="first" contributor_role="author">
                    <given_name>Josiah</given_name>
                    <surname>Carberry</surname>
                    <ORCID>https://orcid.org/0000-0002-1825-0097</ORCID>
                </person_name>
                <person_name sequence="additional" contributor_role="author">
                    <given_name>Fran</given_name>
                    <surname>Whitmorsup</surname>
                    <affiliation>University of Los Angeles</affiliation>
                </person_name>
                <person_name sequence="additional" contributor_role="author">
                    <given_name>Sandra</given_name>
                    <surname>Questcheck</surname>
                </person_name>
            </contributors>
            <publication>
                <full_title>Journal of Psychoceramics</full_title>
                <doi>10.5555/1234567890</doi>
            </publication>
            <titles>
                <title>Theorizing Interfering Appropriation: Headphones for All Ears</title>
            </titles>
            <acceptance_date>
                <month>07</month>
                <day>28</day>
                <year>2018</year>
            </acceptance_date>
            <doi>10.5555/pending-publication-multi-author-crossmark-test</doi>
        </pending_publication>
    </body>
</doi_batch>

Example of a withdrawal 

<doi_batch xmlns="http://www.crossref.org/schema/4.4.2"
    xmlns:fr="http://www.crossref.org/fundref.xsd" xmlns:jats="http://www.ncbi.nlm.nih.gov/JATS1"
    xmlns:mml="http://www.w3.org/1998/Math/MathML"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4.4.2"
    xsi:schemaLocation="http://www.crossref.org/schema/4.4.2 https://www.crossref.org/schemas/crossref4.4.2.xsd">
    <head>
        <doi_batch_id>org.crossref.early.001</doi_batch_id>
        <timestamp>000001</timestamp>
        <depositor>
            <depositor_name>Crossref</depositor_name>
            <email_address>support@crossref.org</email_address>
        </depositor>
        <registrant>Crossref</registrant>
    </head>
    <body>
        <pending_publication>
            <contributors>
                <person_name sequence="first" contributor_role="author">
                    <given_name>Josiah</given_name>
                    <surname>Carberry</surname>
                    <ORCID>https://orcid.org/0000-0002-1825-0097</ORCID>
                </person_name>
            </contributors>
            <publication>
                <full_title>Journal of Psychoceramics</full_title>
                <doi>10.5555/1234567890</doi>
            </publication>
            <titles>
                <title>Categorizing Belligerent Violence: Rockets and/in the Other </title>
            </titles>
            <acceptance_date>
                <month>07</month>
                <day>28</day>
                <year>2018</year>
            </acceptance_date>
            <intent_statement>The article has been withdrawn according to the Crossref Policy on
                Article in Press Withdrawal.</intent_statement>
            <crossmark>
                <crossmark_version>1</crossmark_version>
                <crossmark_policy>10.5555/crossmark_policy</crossmark_policy>
                <crossmark_domains>
                    <crossmark_domain>
                        <domain>psychoceramics.labs.crossref.org</domain>
                    </crossmark_domain>
                </crossmark_domains>
                <crossmark_domain_exclusive>true</crossmark_domain_exclusive>
                <updates>
                    <update type="withdrawal" date="2018-07-28"
                        >10.5555/crossmark-withdrawal-test-for-pendingpub</update>
                </updates>
            </crossmark>
            <doi>10.5555/crossmark-withdrawal-test-for-pendingpub</doi>
        </pending_publication>
    </body>
</doi_batch>
Peer reviews markup guidePosted content (includes preprints) markup guide

Page owner: Patricia Feeney   |   Last updated 2023-October-28