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 932e2977a42c8..6556eef8af510 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
@@ -62,6 +62,14 @@ Version 9 removes these deprecated OpenTelemetry integration classes:
 
 See the <PlatformLink to="/opentelemetry/">OpenTelemetry documentation</PlatformLink> for supported setup options.
 
+## Spring `OPTIONS` Requests Aren't Traced by Default
+
+Version 9 no longer creates automatically instrumented transactions for inbound HTTP `OPTIONS` requests in Spring MVC and Spring WebFlux by default. If your application relies on these transactions, preserve the version 8 behavior with the following Spring Boot property:
+
+```properties {filename:application.properties}
+sentry.trace-options-requests=true
+```
+
 ## Manual Logs and Metrics
 
 Calls to `Sentry.logger()` and `Sentry.metrics()` no longer require a global enable option. Remove calls to: