Contributing to Event Data

There are a number of ways that you can contribute to Event Data. On this page, we show you how to make sure an event is picked up by Event Data, and other ways to get more involved.

How can I create an event?

The easiest way to create an event is to take an action that our agents are tracking. For example, an event will be created if you post a tweet, publish a dataset that is cited by or cites a research article, or add a citation to a Wikipedia article.

Make sure that when you cite a Crossref article you are as specific as possible: including the DOI link, such as or, where this isn’t possible, a link to the article. An event will not be created if you only use details such as the title and authors without including a link. We attempt to track publisher website URLs but they can change and we may not be successful in creating a link based on the website if there is no DOI.

For data citations to be picked up by Event Data, these citations must be included in reference lists deposited with Crossref, and must be in a structured format. A reference that the publisher formats using the “unstructured reference” type will not lead to an event.

If you run a website or service that generates a large number of events, please get in touch about delivering them to us directly. Similarly, if you run a source that we already cover, we would welcome a discussion about the most efficient way to transfer data.

There is something missing from Crossref Event Data, what can I do?

If you see events online that you think should have been included in Event Data, first check our status page to see whether there are any current issues. If not, create a ticket on our Gitlab pages. You can also create a ticket to let us know if you see items missing from our artifacts.

If you have a new source of events that you would like to add, please get in touch to discuss it with us.

Can I contribute to the code base?

Yes, you can! Crossref runs Event Data for the benefit of the scholarly community and we welcome collaborations to develop and improve our code. All of the code is open source and a summary of the elements is available in our Knowledge Database.

Please contact us if you would like to collaborate with us to improve Event Data.

Page owner: Martyn Rittman   |   Last updated 2020-October-06