Gradle "Minimum supported Gradle version is X" in CI

A plugin checked the running Gradle version and refused to load because it needs a newer one. The message states the minimum the plugin accepts and the version the wrapper actually launched, and tells you to update gradle-wrapper.properties.

What this error means

The build fails early with "Minimum supported Gradle version is 8.7. Current version is 8.2. Please fix the project's Gradle settings." It often follows an Android Gradle plugin bump.

> Minimum supported Gradle version is 8.7. Current version is 8.2.
  Please fix the project's Gradle settings.
  To use the version that this plugin requires, update the distributionUrl in
  gradle/wrapper/gradle-wrapper.properties.

Common causes

A plugin upgrade raised the minimum Gradle

Bumping the Android Gradle plugin or another plugin pulled in a version that requires a newer Gradle than the committed wrapper.

The wrapper distribution was pinned to an older line

gradle-wrapper.properties still points at an older distributionUrl, so CI runs the old Gradle even though the plugin needs a newer one.

How to fix it

Update the wrapper distribution

1. Set distributionUrl in gradle/wrapper/gradle-wrapper.properties to the required version.
2. Commit the updated wrapper properties and jar.
3. Run the build through ./gradlew so the new distribution is used.

distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

Bump the wrapper with the wrapper task

Let Gradle rewrite the wrapper files to a target version, then commit the result.

./gradlew wrapper --gradle-version 8.7

How to prevent it

• Bump the Gradle wrapper in the same change that upgrades plugins.
• Always invoke ./gradlew, not a system Gradle, so the pinned version runs.
• Read a plugin release note for its minimum Gradle before upgrading.

Related guides