Conventional Changelog
Conventional Changelog: A flexible open-source CLI/API for convention-driven Markdown changelogs. Ranked #3 of 30 in Changelog Generators by our editors (7.9/10); pricing: Open source; best for customizable Git-based changelog workflows.
At a glance
- Editor score7.9 / 10
- PricingOpen source
- Best forCustomizable Git-based changelog workflows
- Paid fromFree
- Release-note inputsMixed
- Facts checked17 Nov 2026
Where it wins
- CLI and JavaScript API support automation and custom workflows
- Templates, presets, contexts, and output files are configurable
- Monorepo paths, release ranges, previews, and bump recommendations included
Where it doesn't
- Requires Git metadata and convention-based commit messages
- Output is centered on Markdown CHANGELOG.md files
- Support is documentation-based rather than a hosted service
Our verdict on Conventional Changelog
Conventional Changelog is an open-source Node.js toolkit for generating CHANGELOG.md files from Git metadata. It suits teams and individual developers that want changelog generation inside release workflows rather than through a hosted dashboard. The CLI and JavaScript API parse convention-based commits, group entries into sections such as features and bug fixes, and can link entries to commits and releases. Deployment is self-hosted through a command-line tool available on Windows, macOS, and Linux.
Customization is the main strength. Conventional Commits and Angular presets provide established parsing rules, while configurable templates, context, input files, and output files let teams shape the generated Markdown. Preview, append, range, and unreleased modes support different release stages, and monorepo tag-prefix and commit-path options address repositories with multiple package paths. Companion packages add parsing, filtering, writing, and Git client building blocks, plus recommendations for major, minor, or patch version bumps.
This toolkit fits teams that already manage releases in Git and want control over how commit history becomes release documentation. Its CLI deployment and JavaScript API make it suitable for scripts, pipelines, and custom tooling, while the documentation support channel keeps the operating model lightweight. Teams seeking a hosted interface, non-Markdown outputs, or changelog generation without convention-based Git commits may prefer another type of product. Choose Conventional Changelog when repository-native customization matters more than a managed service.
Your product? Our editors can test Conventional Changelog in depth and publish a review, labelled as paid · from $149/mo →
Conventional Changelog pricing
Conventional Changelog fact sheet
| Free plan | Not verified |
|---|---|
| Paid from | Free |
| Release-note inputs | Mixed |
| Output formats | Markdown |
| Template customization | Yes |
| Version bumping | Yes |
| Prerelease handling | Yes |
| Deployment model | Cli |
| Deployment | Self-hosted |
| Platforms | Windows, macOS, Linux |
| Support | Docs |
| Built for | Solo, Small business, Mid-market, Enterprise (editorial estimate) |
| Pricing | Open source |
| Website | conventional-changelog.js.org |
| Facts checked | 17 Nov 2026 |
Alternatives to Conventional Changelog
- semantic-releaseA commit-driven, plugin-based way to automate versions, release notes, and publishing.9.3
- autonewsmdFree, focused Markdown release notes for R users working from Git history.9.1
- ChangelogenA focused CLI for automating semantic releases across GitHub and npm.7.8
See all Conventional Changelog alternatives →
Conventional Changelog vs the competition
- Conventional Changelog vs semantic-release
- Conventional Changelog vs autonewsmd
- Conventional Changelog vs Changelogen
- Conventional Changelog vs Changesets
- Conventional Changelog vs commit-and-tag-version
- Conventional Changelog vs Release Please
Compare Conventional Changelog with any tool side by side →
Used Conventional Changelog? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used Conventional Changelog for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
Conventional Changelog is listed in our Changelog Generators directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/conventional-changelog-changelog-generator/"><img src="https://www.itechguides.com/best/badge/conventional-changelog-changelog-generator.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026
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
