diff --git a/java/migration.md b/java/migration.md
index c3bd586cb..6ae5fbc6f 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -44,6 +44,19 @@ The Production Profile now defaults to `cloud`. This ensures that various proper
 
 [Learn more about the Production Profile.](developing-applications/configuring#production-profile){.learn-more}
 
+### Removed MTX Classic Support
+
+Support for classic MTX (@sap/cds-mtx) has been removed. For multitenancy using streamlined MTX (@sap/cds-mtxs) is mandatory.
+If you are still using MTX Classic refer to the [multitenancy migration guide](../guides/multitenancy/old-mtx-migration).
+
+In addition the deprecated MtSubscriptionService API, which has been superseeded by the DeploymentService API, has been removed.
+As part of this change the compatibility mode for the MtSubscriptionService API has been removed. Besides the removal of the Java APIs this includes the following behavioural changes:
+
+- During unsubscribe the tenant's content (e.g. HDI container) is now deleted by default when using the new DeploymentService API.
+- The HTTP-based tenant upgrade APIs provided by the CAP Java app have been removed. This includes the following endpoints:
+  - `/mt/v1.0/subscriptions/deploy/**` (GET & POST)
+  - `/messaging/v1.0/em/<tenant>` (PUT)
+
 ### Adjusted Property Defaults
 
 Some property defaults have been adjusted:
@@ -77,12 +90,26 @@ Some property defaults have been adjusted:
 
 - `cds.sql.supportedLocales`
 - `cds.security.mock.users.<key>.unrestricted`
+- `cds.multiTenancy.mtxs.enabled`
+- `cds.multiTenancy.compatibility.enabled`
+- `cds.multiTenancy.security.deploymentScope`
 
 ### Removed Java APIs
 
 - Removed deprecated classes:
   - `com.sap.cds.services.environment.ServiceBinding`
   - `com.sap.cds.services.environment.ServiceBindingAdapter`
+  - `com.sap.cds.services.mt.MtSubscriptionService`
+  - `com.sap.cds.services.mt.MtGetDependenciesEventContext`
+  - `com.sap.cds.services.mt.MtSubscribeEventContext`
+  - `com.sap.cds.services.mt.MtAsyncSubscribeEventContext`
+  - `com.sap.cds.services.mt.MtAsyncSubscribeFinishedEventContext`
+  - `com.sap.cds.services.mt.MtDeployEventContext`
+  - `com.sap.cds.services.mt.MtAsyncDeployEventContext`
+  - `com.sap.cds.services.mt.MtAsyncDeployStatusEventContext`
+  - `com.sap.cds.services.mt.MtUnsubscribeEventContext`
+  - `com.sap.cds.services.mt.MtAsyncUnsubscribeEventContext`
+  - `com.sap.cds.services.mt.MtAsyncUnsubscribeFinishedEventContext`
 
 - Removed deprecated methods:
   - `com.sap.cds.services.request.ModifiableUserInfo.setUnrestrictedAttributes`