Simple Changelog Format
Generate a straightforward changelog grouped by the original Conventional Commit type labels like Features, Bug Fixes, and Documentation.
Detailed Explanation
The Simple Format
The Simple format produces a clean, minimal changelog that preserves the original Conventional Commit type labels. Unlike Keep a Changelog, it does not remap types to standardized sections — feat becomes Features, fix becomes Bug Fixes, docs becomes Documentation, and so on.
Output Structure
# 1.2.0 (2026-02-27)
## Features
- **auth:** add OAuth2 login with Google
- add dark mode toggle to settings page
## Bug Fixes
- **auth:** resolve token refresh race condition
- prevent crash when config file is missing
## Documentation
- update API authentication guide
## Build System
- upgrade TypeScript to 5.4
Type Label Mapping
| Commit Type | Section Label |
|---|---|
feat |
Features |
fix |
Bug Fixes |
docs |
Documentation |
perf |
Performance Improvements |
refactor |
Code Refactoring |
test |
Tests |
build |
Build System |
ci |
CI/CD |
chore |
Chores |
revert |
Reverts |
When to Use Simple
The Simple format works best for internal projects, team release notes, or situations where you want maximum detail. Since each commit type gets its own section, readers can distinguish between a documentation update and a build system change — a distinction that Keep a Changelog collapses into a single "Changed" heading.
Use Case
Best suited for internal engineering teams or monorepo projects where granular categorization by commit type provides more value than the simplified Keep a Changelog sections.