From ed58209925b6ae7d217752858d9a04163b185a62 Mon Sep 17 00:00:00 2001
From: Alexander Dinauer <adinauer@users.noreply.github.com>
Date: Tue, 27 Oct 2026 11:48:40 +0100
Subject: [PATCH 1/3] docs(java): Document Hub API removal

Replace the remaining Spring and Android examples that use removed Hub APIs. Add migration mappings for the v9 Scopes APIs and lifecycle-token pattern.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../android/integrations/okhttp/index.mdx     |  6 ++--
 docs/platforms/android/migration/v8-to-v9.mdx | 19 +++++++++++-
 .../java/common/migration/8.x-to-9.0.mdx      | 21 ++++++++++++-
 .../java/guides/spring/advanced-usage.mdx     | 30 +++++++++----------
 4 files changed, 56 insertions(+), 20 deletions(-)

diff --git a/docs/platforms/android/integrations/okhttp/index.mdx b/docs/platforms/android/integrations/okhttp/index.mdx
index 003a1c2187e9d..c7335b38012c2 100644
--- a/docs/platforms/android/integrations/okhttp/index.mdx
+++ b/docs/platforms/android/integrations/okhttp/index.mdx
@@ -302,7 +302,7 @@ private final List<String> failedRequestTargets = Collections.singletonList(".*"
 private final OkHttpClient client = new OkHttpClient.Builder()
   .eventListener(new SentryOkHttpEventListener())
   .addInterceptor(new SentryOkHttpInterceptor(
-    Sentry.getCurrentHub(),
+    Sentry.getCurrentScopes(),
     null,
     true,
     codeRanges,
@@ -340,7 +340,7 @@ private final List<String> failedRequestTargets = Collections.singletonList(".*"
 private final OkHttpClient client = new OkHttpClient.Builder()
   .eventListener(new SentryOkHttpEventListener())
   .addInterceptor(new SentryOkHttpInterceptor(
-    Sentry.getCurrentHub(),
+    Sentry.getCurrentScopes(),
     null,
     true,
     codeRanges,
@@ -378,7 +378,7 @@ private final List<String> failedRequestTargets = Collections.singletonList("mya
 private final OkHttpClient client = new OkHttpClient.Builder()
   .eventListener(new SentryOkHttpEventListener())
   .addInterceptor(new SentryOkHttpInterceptor(
-    Sentry.getCurrentHub(),
+    Sentry.getCurrentScopes(),
     null,
     true,
     codeRanges,
diff --git a/docs/platforms/android/migration/v8-to-v9.mdx b/docs/platforms/android/migration/v8-to-v9.mdx
index e1432a2345878..d5a461d741fd3 100644
--- a/docs/platforms/android/migration/v8-to-v9.mdx
+++ b/docs/platforms/android/migration/v8-to-v9.mdx
@@ -4,7 +4,24 @@ description: "Learn how to migrate from Sentry Android SDK 8.x to 9.0.0."
 sidebar_order: 8890
 ---
 
-Version 9 removes the global Logs and Metrics enable options. Manual telemetry APIs now work whenever the SDK is enabled, while automatic Timber and Logcat capture require their own explicit opt-in.
+Version 9 removes the deprecated Hub compatibility APIs and the global Logs and Metrics enable options. Migrate remaining Hub references to Scopes, then update your telemetry configuration.
+
+## Removed Hub APIs
+
+The Hub compatibility layer was deprecated in version 8 and is removed in version 9. Replace any remaining Hub references before upgrading:
+
+| Removed API                                  | Replacement                                                                   |
+| -------------------------------------------- | ----------------------------------------------------------------------------- |
+| `IHub`                                       | `IScopes`                                                                     |
+| `HubAdapter.getInstance()`                   | `ScopesAdapter.getInstance()`                                                 |
+| `HubScopesWrapper`                           | Use the wrapped `IScopes` instance directly                                   |
+| `NoOpHub.getInstance()`                      | `NoOpScopes.getInstance()`                                                    |
+| `Sentry.getCurrentHub()`                     | `Sentry.getCurrentScopes()`                                                   |
+| `Sentry.setCurrentHub(...)`                  | `Sentry.setCurrentScopes(...)`                                                |
+| `IHub.clone()` and `IScopes.clone()`         | `forkedScopes(...)` or `forkedCurrentScope(...)`                              |
+| `Sentry.popScope()` and `IScopes.popScope()` | Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` |
+
+Use try-with-resources or a `finally` block to close lifecycle tokens. This restores the previous scopes without relying on a separate `popScope()` call.
 
 ## Manual Logs and Metrics
 
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 436907aec025b..f735f25d5b35c 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
@@ -4,7 +4,26 @@ description: "Learn how to migrate from version 8.x to 9.0 of the Sentry Java SD
 sidebar_order: 994
 ---
 
-Version 9 removes the global Logs and Metrics enable options. Manual telemetry APIs now work whenever the SDK is enabled, while automatic logging integrations require their own explicit opt-in.
+Version 9 removes the deprecated Hub compatibility APIs and the global Logs and Metrics enable options. Migrate remaining Hub references to Scopes, then update your telemetry configuration.
+
+## Removed Hub APIs
+
+The Hub compatibility layer was deprecated in version 8 and is removed in version 9. Replace any remaining Hub references before upgrading:
+
+| Removed API                                  | Replacement                                                                   |
+| -------------------------------------------- | ----------------------------------------------------------------------------- |
+| `IHub`                                       | `IScopes`                                                                     |
+| `HubAdapter.getInstance()`                   | `ScopesAdapter.getInstance()`                                                 |
+| `HubScopesWrapper`                           | Use the wrapped `IScopes` instance directly                                   |
+| `NoOpHub.getInstance()`                      | `NoOpScopes.getInstance()`                                                    |
+| `Sentry.getCurrentHub()`                     | `Sentry.getCurrentScopes()`                                                   |
+| `Sentry.setCurrentHub(...)`                  | `Sentry.setCurrentScopes(...)`                                                |
+| `IHub.clone()` and `IScopes.clone()`         | `forkedScopes(...)` or `forkedCurrentScope(...)`                              |
+| `Sentry.popScope()` and `IScopes.popScope()` | Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` |
+| Spring WebFlux `SENTRY_HUB_KEY`              | `SENTRY_SCOPES_KEY`                                                           |
+| GraphQL `ExceptionDetails.getHub()`          | `ExceptionDetails.getScopes()`                                                |
+
+Use try-with-resources or a `finally` block to close lifecycle tokens. This restores the previous scopes without relying on a separate `popScope()` call.
 
 ## Manual Logs and Metrics
 
diff --git a/docs/platforms/java/guides/spring/advanced-usage.mdx b/docs/platforms/java/guides/spring/advanced-usage.mdx
index 9b0117afbae0f..15b6d5a068a43 100644
--- a/docs/platforms/java/guides/spring/advanced-usage.mdx
+++ b/docs/platforms/java/guides/spring/advanced-usage.mdx
@@ -22,7 +22,7 @@ Configuring this field activates the <PlatformLink to="/configuration/options/#d
 2. Register the servlet filter bean `SentryUserFilter`:
 
 ```java {tabTitle:Java (Spring 5)} {mdExpandTabs}
-import io.sentry.IHub;
+import io.sentry.IScopes;
 import io.sentry.spring.SentryUserFilter;
 import io.sentry.spring.SentryUserProvider;
 import java.util.List;
@@ -34,14 +34,14 @@ public class SentryFilterConfig {
 
   @Bean
   public SentryUserFilter sentryUserFilter(
-      final IHub hub, final List<SentryUserProvider> sentryUserProviders) {
-    return new SentryUserFilter(hub, sentryUserProviders);
+      final IScopes scopes, final List<SentryUserProvider> sentryUserProviders) {
+    return new SentryUserFilter(scopes, sentryUserProviders);
   }
 }
 ```
 
 ```java {tabTitle:Java (Spring 6)}
-import io.sentry.IHub;
+import io.sentry.IScopes;
 import io.sentry.spring.jakarta.SentryUserFilter;
 import io.sentry.spring.jakarta.SentryUserProvider;
 import java.util.List;
@@ -53,14 +53,14 @@ public class SentryFilterConfig {
 
   @Bean
   public SentryUserFilter sentryUserFilter(
-      final IHub hub, final List<SentryUserProvider> sentryUserProviders) {
-    return new SentryUserFilter(hub, sentryUserProviders);
+      final IScopes scopes, final List<SentryUserProvider> sentryUserProviders) {
+    return new SentryUserFilter(scopes, sentryUserProviders);
   }
 }
 ```
 
 ```java {tabTitle:Java (Spring 7)}
-import io.sentry.IHub;
+import io.sentry.IScopes;
 import io.sentry.spring7.SentryUserFilter;
 import io.sentry.spring7.SentryUserProvider;
 import java.util.List;
@@ -72,14 +72,14 @@ public class SentryFilterConfig {
 
   @Bean
   public SentryUserFilter sentryUserFilter(
-      final IHub hub, final List<SentryUserProvider> sentryUserProviders) {
-    return new SentryUserFilter(hub, sentryUserProviders);
+      final IScopes scopes, final List<SentryUserProvider> sentryUserProviders) {
+    return new SentryUserFilter(scopes, sentryUserProviders);
   }
 }
 ```
 
 ```kotlin {tabTitle:Kotlin (Spring 5)}
-import io.sentry.IHub
+import io.sentry.IScopes
 import io.sentry.spring.SentryUserProvider
 import io.sentry.spring.SentryUserFilter
 import org.springframework.context.annotation.Bean
@@ -88,12 +88,12 @@ import org.springframework.context.annotation.Configuration
 @Configuration
 class SentryFilterConfig {
     @Bean
-    fun sentryUserFilter(hub: IHub, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(hub, sentryUserProviders)
+    fun sentryUserFilter(scopes: IScopes, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(scopes, sentryUserProviders)
 }
 ```
 
 ```kotlin {tabTitle:Kotlin (Spring 6)}
-import io.sentry.IHub
+import io.sentry.IScopes
 import io.sentry.spring.jakarta.SentryUserProvider
 import io.sentry.spring.jakarta.SentryUserFilter
 import org.springframework.context.annotation.Bean
@@ -102,12 +102,12 @@ import org.springframework.context.annotation.Configuration
 @Configuration
 class SentryFilterConfig {
     @Bean
-    fun sentryUserFilter(hub: IHub, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(hub, sentryUserProviders)
+    fun sentryUserFilter(scopes: IScopes, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(scopes, sentryUserProviders)
 }
 ```
 
 ```kotlin {tabTitle:Kotlin (Spring 7)}
-import io.sentry.IHub
+import io.sentry.IScopes
 import io.sentry.spring7.SentryUserProvider
 import io.sentry.spring7.SentryUserFilter
 import org.springframework.context.annotation.Bean
@@ -116,7 +116,7 @@ import org.springframework.context.annotation.Configuration
 @Configuration
 class SentryFilterConfig {
     @Bean
-    fun sentryUserFilter(hub: IHub, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(hub, sentryUserProviders)
+    fun sentryUserFilter(scopes: IScopes, sentryUserProviders: List<SentryUserProvider>) = SentryUserFilter(scopes, sentryUserProviders)
 }
 ```
 

From 26d680e0496d5f7a5e3c4670812481563ebba3fd Mon Sep 17 00:00:00 2001
From: Alexander Dinauer <adinauer@users.noreply.github.com>
Date: Tue, 27 Oct 2026 11:58:29 +0100
Subject: [PATCH 2/3] docs(java): Expand Hub migration guidance

Carry the v8 Scopes migration guidance into the v9 removal guide. Document lifecycle-token cleanup, independent scope forks, and the supported scope model.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 docs/platforms/android/migration/v8-to-v9.mdx | 52 ++++++++++++-----
 .../java/common/migration/8.x-to-9.0.mdx      | 56 +++++++++++++------
 2 files changed, 78 insertions(+), 30 deletions(-)

diff --git a/docs/platforms/android/migration/v8-to-v9.mdx b/docs/platforms/android/migration/v8-to-v9.mdx
index d5a461d741fd3..8a780664dcfb5 100644
--- a/docs/platforms/android/migration/v8-to-v9.mdx
+++ b/docs/platforms/android/migration/v8-to-v9.mdx
@@ -8,20 +8,44 @@ Version 9 removes the deprecated Hub compatibility APIs and the global Logs and
 
 ## Removed Hub APIs
 
-The Hub compatibility layer was deprecated in version 8 and is removed in version 9. Replace any remaining Hub references before upgrading:
-
-| Removed API                                  | Replacement                                                                   |
-| -------------------------------------------- | ----------------------------------------------------------------------------- |
-| `IHub`                                       | `IScopes`                                                                     |
-| `HubAdapter.getInstance()`                   | `ScopesAdapter.getInstance()`                                                 |
-| `HubScopesWrapper`                           | Use the wrapped `IScopes` instance directly                                   |
-| `NoOpHub.getInstance()`                      | `NoOpScopes.getInstance()`                                                    |
-| `Sentry.getCurrentHub()`                     | `Sentry.getCurrentScopes()`                                                   |
-| `Sentry.setCurrentHub(...)`                  | `Sentry.setCurrentScopes(...)`                                                |
-| `IHub.clone()` and `IScopes.clone()`         | `forkedScopes(...)` or `forkedCurrentScope(...)`                              |
-| `Sentry.popScope()` and `IScopes.popScope()` | Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` |
-
-Use try-with-resources or a `finally` block to close lifecycle tokens. This restores the previous scopes without relying on a separate `popScope()` call.
+Version 8 deprecated Hub and introduced Scopes. Version 9 removes the Hub compatibility layer:
+
+- `IHub` has been removed. Use `IScopes` instead.
+- `HubAdapter.getInstance()` has been removed. Use `ScopesAdapter.getInstance()` instead.
+- `HubScopesWrapper` has been removed. Use the wrapped `IScopes` instance directly.
+- `NoOpHub.getInstance()` has been removed. Use `NoOpScopes.getInstance()` instead.
+- `Sentry.getCurrentHub()` and `Sentry.setCurrentHub(...)` have been removed. Use `Sentry.getCurrentScopes()` and `Sentry.setCurrentScopes(...)` instead.
+- `IHub.clone()` and `IScopes.clone()` have been removed. Use `forkedScopes(...)` or `forkedCurrentScope(...)` when you need an independent Scopes instance. For temporary scope changes, use `pushScope()`, `pushIsolationScope()`, `withScope()`, or `withIsolationScope()`.
+
+### Remove `popScope()` Calls
+
+`Sentry.popScope()` and `IScopes.popScope()` have been removed. Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` to restore the previous scopes:
+
+```java
+try (ISentryLifecycleToken ignored = Sentry.pushScope()) {
+  // This block has its own current scope.
+}
+```
+
+Use the same pattern for an isolation scope:
+
+```java
+try (ISentryLifecycleToken ignored = Sentry.pushIsolationScope()) {
+  // This block has its own isolation scope.
+}
+```
+
+If you can't use try-with-resources, close the token in a `finally` block.
+
+### Scopes Model
+
+The Scopes model introduced in version 8 is the supported context model in version 9:
+
+- The global scope is attached to all events created by the SDK. It can be modified before `SentryAndroid.init()` by calling `Sentry.configureScope(ScopeType.GLOBAL, callback)`.
+- The isolation scope attaches data to events within an isolated lifecycle.
+- The current scope contains data for the active operation. Child scopes inherit its data, but parent scopes don't receive changes made in a child scope.
+
+On Android, APIs such as `Sentry.configureScope()` and `Sentry.setTag()` use the current scope by default.
 
 ## Manual Logs and Metrics
 
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 f735f25d5b35c..9c4b59fb1b55f 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
@@ -8,22 +8,46 @@ Version 9 removes the deprecated Hub compatibility APIs and the global Logs and
 
 ## Removed Hub APIs
 
-The Hub compatibility layer was deprecated in version 8 and is removed in version 9. Replace any remaining Hub references before upgrading:
-
-| Removed API                                  | Replacement                                                                   |
-| -------------------------------------------- | ----------------------------------------------------------------------------- |
-| `IHub`                                       | `IScopes`                                                                     |
-| `HubAdapter.getInstance()`                   | `ScopesAdapter.getInstance()`                                                 |
-| `HubScopesWrapper`                           | Use the wrapped `IScopes` instance directly                                   |
-| `NoOpHub.getInstance()`                      | `NoOpScopes.getInstance()`                                                    |
-| `Sentry.getCurrentHub()`                     | `Sentry.getCurrentScopes()`                                                   |
-| `Sentry.setCurrentHub(...)`                  | `Sentry.setCurrentScopes(...)`                                                |
-| `IHub.clone()` and `IScopes.clone()`         | `forkedScopes(...)` or `forkedCurrentScope(...)`                              |
-| `Sentry.popScope()` and `IScopes.popScope()` | Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` |
-| Spring WebFlux `SENTRY_HUB_KEY`              | `SENTRY_SCOPES_KEY`                                                           |
-| GraphQL `ExceptionDetails.getHub()`          | `ExceptionDetails.getScopes()`                                                |
-
-Use try-with-resources or a `finally` block to close lifecycle tokens. This restores the previous scopes without relying on a separate `popScope()` call.
+Version 8 deprecated Hub and introduced Scopes. Version 9 removes the Hub compatibility layer:
+
+- `IHub` has been removed. Use `IScopes` instead.
+- `HubAdapter.getInstance()` has been removed. Use `ScopesAdapter.getInstance()` instead.
+- `HubScopesWrapper` has been removed. Use the wrapped `IScopes` instance directly.
+- `NoOpHub.getInstance()` has been removed. Use `NoOpScopes.getInstance()` instead.
+- `Sentry.getCurrentHub()` and `Sentry.setCurrentHub(...)` have been removed. Use `Sentry.getCurrentScopes()` and `Sentry.setCurrentScopes(...)` instead.
+- `IHub.clone()` and `IScopes.clone()` have been removed. Use `forkedScopes(...)` or `forkedCurrentScope(...)` when you need an independent Scopes instance. For temporary scope changes, use `pushScope()`, `pushIsolationScope()`, `withScope()`, or `withIsolationScope()`.
+- Spring WebFlux's `SENTRY_HUB_KEY` has been removed. Use `SENTRY_SCOPES_KEY` instead.
+- GraphQL's `ExceptionDetails.getHub()` has been removed. Use `ExceptionDetails.getScopes()` instead.
+
+### Remove `popScope()` Calls
+
+`Sentry.popScope()` and `IScopes.popScope()` have been removed. Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` to restore the previous scopes:
+
+```java
+try (ISentryLifecycleToken ignored = Sentry.pushScope()) {
+  // This block has its own current scope.
+}
+```
+
+Use the same pattern for an isolation scope:
+
+```java
+try (ISentryLifecycleToken ignored = Sentry.pushIsolationScope()) {
+  // This block has its own isolation scope.
+}
+```
+
+If you can't use try-with-resources, close the token in a `finally` block.
+
+### Scopes Model
+
+The Scopes model introduced in version 8 is the supported context model in version 9:
+
+- The global scope is attached to all events created by the SDK. It can be modified before `Sentry.init()` by calling `Sentry.configureScope(ScopeType.GLOBAL, callback)`.
+- The isolation scope attaches data to events within an isolated lifecycle, such as an incoming request. The SDK automatically forks this scope for incoming requests, CRON jobs, Spring `@Async`, and other integrations.
+- The current scope contains data for the active operation. Child scopes inherit its data, but parent scopes don't receive changes made in a child scope.
+
+For backend and other JVM applications, APIs such as `Sentry.configureScope()` and `Sentry.setTag()` use the isolation scope by default.
 
 ## Manual Logs and Metrics
 

From 87a8c5c9cb84b3be81f52334b0018b1cf40d3464 Mon Sep 17 00:00:00 2001
From: Alexander Dinauer <adinauer@users.noreply.github.com>
Date: Tue, 27 Oct 2026 15:32:23 +0100
Subject: [PATCH 3/3] docs(java): Correct v9 scope migration guidance

Use balanced scope callbacks in the Android migration guide because static
push operations do not fork scopes in Android's default global hub mode.
Document the persistent global scope API for configuration before SDK init.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 docs/platforms/android/migration/v8-to-v9.mdx | 22 +++----------------
 .../java/common/migration/8.x-to-9.0.mdx      |  2 +-
 2 files changed, 4 insertions(+), 20 deletions(-)

diff --git a/docs/platforms/android/migration/v8-to-v9.mdx b/docs/platforms/android/migration/v8-to-v9.mdx
index 8a780664dcfb5..623ada90f4c85 100644
--- a/docs/platforms/android/migration/v8-to-v9.mdx
+++ b/docs/platforms/android/migration/v8-to-v9.mdx
@@ -15,33 +15,17 @@ Version 8 deprecated Hub and introduced Scopes. Version 9 removes the Hub compat
 - `HubScopesWrapper` has been removed. Use the wrapped `IScopes` instance directly.
 - `NoOpHub.getInstance()` has been removed. Use `NoOpScopes.getInstance()` instead.
 - `Sentry.getCurrentHub()` and `Sentry.setCurrentHub(...)` have been removed. Use `Sentry.getCurrentScopes()` and `Sentry.setCurrentScopes(...)` instead.
-- `IHub.clone()` and `IScopes.clone()` have been removed. Use `forkedScopes(...)` or `forkedCurrentScope(...)` when you need an independent Scopes instance. For temporary scope changes, use `pushScope()`, `pushIsolationScope()`, `withScope()`, or `withIsolationScope()`.
+- `IHub.clone()` and `IScopes.clone()` have been removed. Use `forkedScopes(...)` or `forkedCurrentScope(...)` when you need an independent Scopes instance. For temporary scope changes, use `withScope()` or `withIsolationScope()`.
 
 ### Remove `popScope()` Calls
 
-`Sentry.popScope()` and `IScopes.popScope()` have been removed. Close the lifecycle token returned by `pushScope()` or `pushIsolationScope()` to restore the previous scopes:
-
-```java
-try (ISentryLifecycleToken ignored = Sentry.pushScope()) {
-  // This block has its own current scope.
-}
-```
-
-Use the same pattern for an isolation scope:
-
-```java
-try (ISentryLifecycleToken ignored = Sentry.pushIsolationScope()) {
-  // This block has its own isolation scope.
-}
-```
-
-If you can't use try-with-resources, close the token in a `finally` block.
+`Sentry.popScope()` and `IScopes.popScope()` have been removed. Use `Sentry.withScope()` or `Sentry.withIsolationScope()` for temporary scope changes instead. Both methods restore the previous scopes after the callback finishes.
 
 ### Scopes Model
 
 The Scopes model introduced in version 8 is the supported context model in version 9:
 
-- The global scope is attached to all events created by the SDK. It can be modified before `SentryAndroid.init()` by calling `Sentry.configureScope(ScopeType.GLOBAL, callback)`.
+- The global scope is attached to all events created by the SDK. To modify it before `SentryAndroid.init()`, call methods directly on `Sentry.getGlobalScope()`, such as `Sentry.getGlobalScope().setTag(...)`.
 - The isolation scope attaches data to events within an isolated lifecycle.
 - The current scope contains data for the active operation. Child scopes inherit its data, but parent scopes don't receive changes made in a child scope.
 
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 9c4b59fb1b55f..220525e0129c3 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
@@ -43,7 +43,7 @@ If you can't use try-with-resources, close the token in a `finally` block.
 
 The Scopes model introduced in version 8 is the supported context model in version 9:
 
-- The global scope is attached to all events created by the SDK. It can be modified before `Sentry.init()` by calling `Sentry.configureScope(ScopeType.GLOBAL, callback)`.
+- The global scope is attached to all events created by the SDK. To modify it before `Sentry.init()`, call methods directly on `Sentry.getGlobalScope()`, such as `Sentry.getGlobalScope().setTag(...)`.
 - The isolation scope attaches data to events within an isolated lifecycle, such as an incoming request. The SDK automatically forks this scope for incoming requests, CRON jobs, Spring `@Async`, and other integrations.
 - The current scope contains data for the active operation. Child scopes inherit its data, but parent scopes don't receive changes made in a child scope.