Skip to the content.

Semantic Versioning Plugin

License: MIT CircleCI Gradle Plugin Portal

Gradle plugin that provides Semantic Versioning with auto-increment features.

How to

Add it in your project build.gradle.kts at the end of plugins.

Using the plugins DSL:

plugins {
    id("com.sherepenko.gradle.plugin-build-version") version "x.y.z"

Using legacy plugin application:

buildscript {
    repositories {
        maven {
            url = uri("")

    dependencies {

apply(plugin = "com.sherepenko.gradle.plugin-build-version")


Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backward compatible manner, and
  3. PATCH version when you make backward compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

Gradle tasks