diff --git a/docs/platforms/javascript/guides/capacitor/migration/v1-to-v2/index.mdx b/docs/platforms/javascript/guides/capacitor/migration/v1-to-v2/index.mdx
new file mode 100644
index 00000000000000..41b14f42b68787
--- /dev/null
+++ b/docs/platforms/javascript/guides/capacitor/migration/v1-to-v2/index.mdx
@@ -0,0 +1,35 @@
+---
+title: Migrate from 1.x to 2.x
+sidebar_order: 7920
+description: "Learn about migrating from Sentry Capacitor SDK 1.x to 2.x"
+---
+
+Version 2 of the Sentry Capacitor SDK primarily introduces API cleanup and version support changes.
+
+This update contains behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling.
+
+Version 2 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v1). Lower versions may continue to work, but may not support all features.
+
+### TypeScript Version Policy
+
+In preparation for v2 of the OpenTelemetry SDK, the minimum required TypeScript version is increased to version `5.0.4`.
+
+
+## How to upgrade to SDK version 2:
+
+- Capacitor version 2 depends on Sentry JavaScript SDK version 9. We recommend reading below [migration guide](#sibling-migration-guide) docs to find out how to address any breaking changes when upgrading the sibling SDKs.
+
+<Alert level="warning" title="Important">
+To prevent issues, use fixed versions of Sentry Capacitor and the Sibling SDK. Always install the Sibling SDK version that matches Sentry Capacitor.
+</Alert>
+
+## Sibling migration guide
+
+Each Sibling SDK has specific changes in version 9. Follow the tutorials below to update the SDK.
+
+- [Angular SDK 8.x to 9.x migration guide](/platforms/javascript/guides/angular/migration/v8-to-v9/).
+- [React SDK 8.x to 9.x migration guide](/platforms/javascript/guides/react/migration/v8-to-v9/).
+- [Vue SDK 8.x to 9.x migration guide](/platforms/javascript/guides/vue/migration/v8-to-v9/).
+- [Nuxt SDK 8.x to 9.x migration guide](/platforms/javascript/guides/nuxt/migration/v8-to-v9/).
+
+<PageGrid/>
\ No newline at end of file