Setup Zenodo DOI badge before the first release

zenodo-doi-first-badge.md

Setup Zenodo DOI badge before the first release

Before submitting your first release, identify your Github repo id on Github API at:

https://api.github.com/repos/{user}/{repo}

Then add the following badge to your README.md:

[![DOI](https://zenodo.org/badge/{github_id}.svg)](https://zenodo.org/badge/latestdoi/{github_id})

or to your README.rst:

|DOI|

.. |DOI| image:: https://zenodo.org/badge/{github_id}.svg
        :target: https://zenodo.org/badge/latestdoi/{github_id}

Then, submit your first release

Notes:

• The DOI badge will not be issued until you make you first release but will be included in your release.
• See Github documentation to setup Zenodo webhooks.

Except for the top-most one on this page, the Zenodo DOI badges render like this now (as of Jan 2026):

Is this an issue with GitHub? The SVG links are still available if you follow them, but not on GitHub.