Files
upstream-grpc-go/Documentation/versioning.md
upstream-mirror e241b33f26
Some checks failed
codecov / upload (push) Failing after 13m59s
CodeQL / Analyze (push) Failing after 1s
Testing / vet-proto (push) Failing after 1s
Testing / tests (arm, latest) (push) Waiting to run
Testing / extras (latest) (push) Failing after 1s
Testing / static checks (latest-1) (push) Failing after 1s
Testing / tests (-race, latest) (push) Failing after 1s
Testing / tests (i386, latest) (push) Failing after 1s
Testing / tests (latest) (push) Failing after 1s
Testing / tests (latest-1) (push) Failing after 1s
Lock Threads / lock (push) Failing after 1s
govulncheck / govulncheck (.) (push) Failing after 1s
govulncheck / govulncheck (./cmd/protoc-gen-go-grpc) (push) Failing after 1s
govulncheck / govulncheck (./gcp/observability) (push) Failing after 1s
govulncheck / govulncheck (./security/advancedtls) (push) Failing after 1s
govulncheck / govulncheck (./stats/opencensus) (push) Failing after 1s
Stale bot / stale (push) Failing after 1s
snapshot of https://github.com/grpc/grpc-go.git (master, 2026-09-15; blobs > 131072B omitted)
2026-09-15 20:40:15 +05:00

1.2 KiB

Versioning and Releases

Note: This document references terminology defined at http://semver.org.

Release Frequency

Regular MINOR releases of gRPC-Go are performed every six weeks. Patch releases to the previous two MINOR releases may be performed on demand or if serious security problems are discovered.

Versioning Policy

The gRPC-Go versioning policy follows the Semantic Versioning 2.0.0 specification, with the following exceptions:

  • A MINOR version will not necessarily add new functionality.

  • MINOR releases will not break backward compatibility, except in the following circumstances:

    • An API was marked as EXPERIMENTAL upon its introduction.
    • An API was marked as DEPRECATED in the initial MAJOR release.
    • An API is inherently flawed and cannot provide correct or secure behavior.

    In these cases, APIs MAY be changed or removed without a MAJOR release. Otherwise, backward compatibility will be preserved by MINOR releases.

    For an API marked as DEPRECATED, an alternative will be available (if appropriate) for at least three months prior to its removal.

Release History

Please see our release history on GitHub: https://github.com/grpc/grpc-go/releases