Safeguard
Developer Tools•

Should a security fix ship as a patch release?

Yes, when the fix is backward compatible. SemVer reserves patch releases for compatible bug fixes, and Maven Central advises fixing bugs with a new patch.

Safeguard Security Team
4 min read

Yes, if the fix does not change the public API. Semantic Versioning says the patch number must be incremented when only backward compatible bug fixes are introduced. Maven Central's guidance for a published bug also points to a new patch release. A patch tells users the upgrade is safe to take quickly.

What the sources say

The SemVer specification states that the patch version must be incremented if only backward compatible bug fixes are introduced, and defines a bug fix as an internal change that fixes incorrect behaviour. A minor version covers new compatible functionality or deprecations, and a major version covers incompatible changes.

The Maven Central immutability page gives parallel advice. Published components are not removed or modified. If you published a component with a bug, the recommended path, in its words, is a new release with the fix, ideally a patch release if you use Semantic Versioning, to communicate compatibility with the previous version. Then broadcast the release to your users through your communication channels.

Why the label matters

Users and tools decide how fast to act from the version number. A patch bump tends to be accepted quickly, sometimes automatically. If you hide a security fix inside a minor release with new features, many users will delay the upgrade to test the features, and the vulnerable version stays in use longer.

Fix typeSuggested releaseNotes
Compatible security fixPatchState clearly in the notes that it is a security fix
Fix that needs a new option or defaultMinorExplain the change and how to opt in
Fix that must break the APIMajor releaseRare. Document the break in the advisory

Backport to every supported line

A single patch on the newest line leaves users on older supported lines exposed. Publish a patch for each branch you say you support. The Django project's statement that patch releases are fully compatible, except where security or data loss prevent it, shows the promise users hope to rely on.

What the release notes should say

Note the fixed version, the affected range, the weakness type, and a link to the advisory. The OpenSSF badge criteria also say release notes should identify each publicly known runtime vulnerability fixed in the release that already had a CVE or similar when the release was created, with exceptions for cases where users cannot practically update. Following that makes it easier for scanners and teams to match your fix to their records.

Steps

  1. Prepare the fix on the main branch with a test.
  2. Backport it to each supported branch as a patch release.
  3. Mark each release notes entry as a security fix, with the advisory link.
  4. Publish the advisory and release on the same day.
  5. Tell users through the channels named in your security policy.
  6. Do not edit or replace a published release. Ship a new one.

Try it yourself

Click through it at your own pace, or open it full screen. See how a fixed version is presented, and judge how confident you would be taking an upgrade labelled as a patch.

Quick check

Can I republish the same version with the fix?

Registries such as Maven Central do not remove or modify published components. Publish a new version.

What if the fix needs an API change?

Use a minor or major release as appropriate, and explain the reason and the migration in the advisory.

Should release notes name the CVE?

The OpenSSF criteria say they should for publicly known runtime vulnerabilities that already had one when the release was created.

How Safeguard helps

Safeguard can help you keep the support dates in view. Its SBOM and dependency scanning list the exact versions you run, reachability analysis shows which known issues your code can actually reach, and policies and gates can stop a build that pulls in a version you have decided to retire. Autonomous remediation can open fix pull requests; it is off by default and every category starts on Manual. You can try the free scan on a manifest first.

Sources

Last reviewed: 19 October 2026.

Never miss an update

Weekly insights on software supply chain security, delivered to your inbox.

Self-healing security runs on Safeguard.

Your first fix PR is minutes away.

No sales call required, even your agent can complete the purchase over MCP.