Description

When using a custom tag_format like ${major}.${minor}-${patch}${prerelease} with semver2 the changelog cannot be create directly using cz bump --prerelase rc with update_changelog_on_bump = true. Only generating the changelog manually using cz ch lets the bump succeed.

The error occurse in a bump chain 0.0.1 → 0.0.2 → 0.0.3-rc.0 → 0.0.3-rc.1

Furthermore, using prereleases, cz changelog always throw warnings like:

Invalid version tag: '0.0-2rc.0' does not match any configured tag format

It seems that the git tag is not parsed correctly when using custom tag_format and semver2.

See a szenario in steps to reproduce.

Steps to reproduce

1. Initialize git project and place cz configuration:

git init . cat << EOF | tee cz.toml [tool.commitizen] name = "cz_conventional_commits" tag_format = "\${major}.\${minor}-\${patch}\${prerelease}" version_scheme = "semver2" version = "0.0.1" update_changelog_on_bump = true EOF 

2. Create a first commit

echo "# test" | tee README.md git add README.md cz.toml git commit -m "fix: Add readme file" 

3. Bump a prerelease

cz bump --prerelease rc --yes 

4. Add changes, commit and create changelog

echo "Some changes" | tee -a README.md git add README.md git commit -m "fix: Add changes to readme file" 

5. Try to bump another prerelease version (failing)

cz bump --prerelease rc --yes 

5. Generate changelog (succeeding with warning)

cz changelog 

6. Try to bump prerelease version again (succeeding)

cz bump --prerelease rc 

Current behavior

Bumping without prior changelog generation fails with:

Invalid version tag: '0.0-2rc.0' does not match any configured tag format

Only if the changelog is created before bumping (so that # Unreleased heading appears) let's you create a bump.

Furthermore commitizen does not recognize custom tags with prerelease part correctly, resulting in warnings using cz changelog like:

Invalid version tag: '0.0-2rc.1' does not match any configured tag format Invalid version tag: '0.0-2rc.0' does not match any configured tag format 

Desired behavior

1. Changelog generation shall recognize the tags using custom tag_format with ${prerelease}
2. Bumping with changelog creation shall succeed without generating changelog before

Screenshots

n/a

Environment

Commitizen Version: 4.9.1
Python Version: 3.9.21 (main, Aug 19 2025, 00:00:00)
[GCC 11.5.0 20240719 (Red Hat 11.5.0-5)]
Operating System: Linux