Suggestions appear as you type. Use the up and down arrows to choose one and Enter to open it.

Conventional Changelog

Free#3 of 30 in Changelog Generators

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.

7.9/10Editor score
Conventional Changelog7.9 Explore toolkit

At a glance

  • Editor score
    7.9 / 10
  • Pricing
    Open source
  • Best for
    Customizable Git-based changelog workflows
  • Paid from
    Free
  • Release-note inputs
    Mixed
  • Facts checked
    17 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

Plans Open sourceFree Free to use — no paid tier required for the core job.
See plans on conventional-changelog.js.org

Conventional Changelog fact sheet

Free planNot verified
Paid fromFree
Release-note inputsMixed
Output formatsMarkdown
Template customizationYes
Version bumpingYes
Prerelease handlingYes
Deployment modelCli
DeploymentSelf-hosted
PlatformsWindows, macOS, Linux
SupportDocs
Built forSolo, Small business, Mid-market, Enterprise (editorial estimate)
PricingOpen source
Websiteconventional-changelog.js.org
Facts checked17 Nov 2026

Alternatives to Conventional Changelog

See all Conventional Changelog alternatives →

Conventional Changelog vs the competition

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

Reviews come only from verified accounts. Sign in or create an account first — your e-mail is never shown.

Your rating

0 characters · at least 80, up to 3,000

Posted from your verified account. Reviews appear after an editor reads them, usually within two working days.

Featured on iTechGuides

Featured on iTechGuides — Conventional Changelog 7.9/10

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