Repository citation files get first-class support
GitHub has added native support for CITATION.cff files, letting repository owners specify exactly how their work should be cited. When a CITATION.cff file is present, GitHub automatically generates APA and BibTeX citation links that visitors can use. The feature is aimed primarily at academics and researchers who publish code, data, and other research outputs but often struggle to get proper attribution for those contributions.
Some of the most widely used projects on the platform — from real-time COVID-19 dashboards to the Event Horizon Telescope software behind the first black hole image — come out of the research community. In many fields, tenure and promotion decisions still depend heavily on formal citations in peer-reviewed literature. Open-source software is rarely treated as a citable research output, even when it supplies implementations, tests, and datasets that underpin published findings. This leaves contributors with a professional skills gap: strong code can be more valuable than a paper, but it may not earn equivalent academic credit unless peers know how to reference it.
How citation rendering works
GitHub parses the contents of a CITATION.cff file using the ruby-cff RubyGem to construct the formatted citation string shown on the repository page.
Beyond the CITATION.cff format itself, GitHub also detects other citation formats in common use. A repository that includes inst/CITATION, for example (the standard location for R package citation metadata), will get a linked citation as well.
Feedback and next steps
Software citation in academic workflows is still an evolving practice, and GitHub expects the feature to change as researchers weigh in. The initial design was reviewed with the creators of the Citation File Format and a small group of beta testers. Developers can discuss further improvements by contributing to the ruby-cff repository, or consult the official documentation to add a filename to their own repositories.
