Skip to main content

Release Processing and Overrides

Release Processing and Overrides

Active

Extract useful release content, then customize individual versions without changing global rules.

Command[tool.custy.changelog.release]

Category

Changelog Configuration

Quick Command

[tool.custy.changelog.release_behavior."VERSION"]

release summaryhiddencustom message

Release Properties

Properties

PropertyTypeDescriptionDefaultRequired
extract_bullets_onlyBooleanUse Markdown list items from release summaries and ignore preceding narrative.trueNo
fallback_to_subjectBooleanUse the release summary or commit subject when no list items exist; otherwise skip the empty release entry.trueNo
Global release processing
toml
[tool.custy.changelog.release]
extract_bullets_only = true
fallback_to_subject = true

Per-Version Behavior

Properties

PropertyTypeDescriptionDefaultRequired
hiddenBooleanExclude the version completely. When true, it overrides title_only and custom_message.falseNo
title_onlyBooleanRender only the release heading and suppress its body.falseNo
custom_messageStringReplace the generated release summary while retaining generated change groups unless hidden.unsetNo
Per-version examples
toml
[tool.custy.changelog.release_behavior."1.10.13"]
custom_message = """
Repository synchronization improvements.
"""

[tool.custy.changelog.release_behavior."1.10.12"]
hidden = true

[tool.custy.changelog.release_behavior."1.10.11"]
title_only = true

Continue