Scope and Type Mappings
Scope and Type Mappings
Active and Extensible
Translate machine-oriented commit classification into stable, reader-friendly section names.
Command
[tool.custy.changelog.scope_map] + [tool.custy.changelog.type_map]Category
Changelog Configuration
Quick Command
RAW_KEY = "Display label"Scope Mapping
Every key is a raw commit scope; every value is the displayed scope. Unmapped scopes retain their original name.
Generated scope_map entries
| Property | Type | Description | Default | Required |
|---|---|---|---|---|
main | Display main as core. | core | No | |
auth | Expand the authentication scope. | authentication | No | |
cli | Preserve CLI labeling. | cli | No | |
changelog | Preserve changelog labeling. | changelog | No | |
workflow | Preserve workflow labeling. | workflow | No | |
template | Preserve template labeling. | template | No | |
config | Expand config to configuration. | configuration | No | |
docs | Expand docs to documentation. | documentation | No | |
tests | Preserve tests labeling. | tests | No |
Type Mapping
The mapping also provides stable group order when sort_groups = false.
Unknown types use the value assigned to other.
Generated type_map entries
| Property | Type | Description | Default | Required |
|---|---|---|---|---|
feat | New user-facing functionality. | ✨ Features | No | |
fix | Corrective changes. | 🐛 Bug Fixes | No | |
improvement | Enhancements not classified as features. | 🧠 Improvements | No | |
template | Template changes. | 📄 Templates | No | |
breaking | Backward-incompatible changes. | ⚠️ Breaking Changes | No | |
docs | Documentation changes. | 📚 Documentation | No | |
refactor | Internal restructuring. | 🧠 Refactoring | No | |
perf | Performance improvements. | ⚡ Performance | No | |
test | Test changes. | 🧪 Tests | No | |
chore | Maintenance work. | 🔧 Chores | No | |
ci | Continuous integration and delivery changes. | ⚙️ CI/CD | No | |
build | Build-system changes. | 🏗️ Build | No | |
release | Release-oriented commits. | 🚀 Releases | No | |
revert | Reverted changes. | ↩️ Reverts | No | |
style | Formatting or style-only changes. | 🎨 Styling | No | |
other | Fallback title for unknown commit types. | 📦 Others | No |
Custom mapping
toml[tool.custy.changelog.scope_map]
database = "data layer"
[tool.custy.changelog.type_map]
security = "🔐 Security"