Towncrier review
A self-hosted command-line tool for turning project news fragments into changelogs.
Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026
Towncrier is an open-source command-line utility for teams that maintain project release notes alongside their code. Contributors create small news fragments describing user-facing changes, and Towncrier combines them into a configured changelog file. This fragment-based workflow can help avoid multiple contributors editing the same changelog directly. It is suited to projects that want control over how release notes are assembled, rather than a hosted service for publishing updates to an audience.
The workflow covers fragment creation, validation, and changelog generation. Towncrier supports reStructuredText and Markdown news files, configurable fragment directories and output file names, customizable templates, and sections based on fragment types. It can also generate a draft without finalizing fragments, which supports review before producing the final file. Git, Mercurial, and pre-commit are listed integrations. Towncrier requires Python, though its documentation says projects in other languages can use it when Python-specific features are not needed. Documentation and community are the listed support channels.
Towncrier is free and open source, with self-hosted deployment across Linux, macOS, and Windows described in its documentation. Its scope is deliberately centered on assembling project changelogs: it generates files rather than providing a hosted release-notes publication service. Audience targeting, approval workflows, analytics, and API access are not part of its listed capabilities. Teams seeking a focused fragment workflow and configurable output should consider it; teams that need publishing, audience delivery, or release-note analytics should look for a broader product.
Questions about Towncrier
What does Towncrier run on? Linux, macOS and Windows. It runs self-hosted.
What does Towncrier integrate with? 3 integrations: pre-commit, Git and Mercurial.
Who is Towncrier built for? Small businesses, mid-market companies and enterprises (our editorial estimate).
Towncrier pros and cons
- Where it wins
- Builds changelogs from validated news fragments
- Supports reStructuredText, Markdown, configurable sections, and templates
- Works with Git, Mercurial, and pre-commit
- Where it doesn't
- Requires Python to run
- Generates changelog files rather than hosted release-note pages
- Has no audience targeting, approval workflow, or analytics
Towncrier fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update