diff --git a/docs/platforms/java/common/index.mdx b/docs/platforms/java/common/index.mdx
index 2f8445f0ca87d..3a7de188f71be 100644
--- a/docs/platforms/java/common/index.mdx
+++ b/docs/platforms/java/common/index.mdx
@@ -1,5 +1,11 @@
+
+
+Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8.
+
+
+
On this page, we get you up and running with Sentry's SDK.
diff --git a/docs/platforms/java/common/migration/8.x-to-9.0.mdx b/docs/platforms/java/common/migration/8.x-to-9.0.mdx
index 70ece012077e1..67eca79c673ae 100644
--- a/docs/platforms/java/common/migration/8.x-to-9.0.mdx
+++ b/docs/platforms/java/common/migration/8.x-to-9.0.mdx
@@ -6,6 +6,10 @@ sidebar_order: 994
Version 9 removes deprecated Hub compatibility and OpenTelemetry APIs, along with the global Logs and Metrics enable options. Migrate remaining Hub and OpenTelemetry references, then update your telemetry configuration.
+## Minimum Java Version
+
+The Sentry Java SDK is now compiled for Java 11. To use version 9, configure your build to use a Java 11 or newer compiler/toolchain and run your application on Java 11 or newer. Stay on Sentry Java SDK 8.x if either environment must remain on Java 8.
+
## Removed Hub APIs
Version 8 deprecated Hub and introduced Scopes. Version 9 removes the Hub compatibility layer:
diff --git a/docs/platforms/java/guides/spring-boot/index.mdx b/docs/platforms/java/guides/spring-boot/index.mdx
index fedb5bdefc6e3..cadde6d2dc943 100644
--- a/docs/platforms/java/guides/spring-boot/index.mdx
+++ b/docs/platforms/java/guides/spring-boot/index.mdx
@@ -6,6 +6,12 @@ sdk: sentry.java.spring-boot
+
+
+Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8.
+
+
+
On this page, we get you up and running with Sentry's SDK.
Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page.
diff --git a/docs/platforms/java/guides/spring/index.mdx b/docs/platforms/java/guides/spring/index.mdx
index 1907d6bcc77ee..44c291832bc9c 100644
--- a/docs/platforms/java/guides/spring/index.mdx
+++ b/docs/platforms/java/guides/spring/index.mdx
@@ -6,6 +6,12 @@ sdk: sentry.java.spring
+
+
+Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8.
+
+
+
On this page, we get you up and running with Sentry's SDK.
Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page.