---
title: "Migrate from 1.x to 2.x"
description: "Learn about migrating from Sentry Capacitor SDK 1.x to 2.x"
url: https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2/
---

# Migrate from 1.x to 2.x | Sentry for Capacitor

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](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#typescript-version-policy)

In preparation for v2 of the OpenTelemetry SDK, the minimum required TypeScript version is increased to version `5.0.4`.

### [Dropping Support for Capacitor 5 and Earlier](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#dropping-support-for-capacitor-5-and-earlier)

To ensure the best experience with the latest Capacitor features, support for Capacitor 5 and earlier will be discontinued starting with version 2.0. We recommend upgrading to Capacitor 6 or later. If you need to continue using older Capacitor versions, please stick with Sentry Capacitor SDK v1.

### [Self-Hosted Sentry Compatibility](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#self-hosted-sentry-compatibility)

Beginning with version 2.0.0, the Sentry Capacitor SDK will only support self-hosted Sentry instances version 25.2.0 and above. This change does not affect users of `sentry.io`.

## [How to upgrade to SDK version 2:](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#how-to-upgrade-to-sdk-version-2)

* Capacitor version 2 depends on Sentry JavaScript SDK version 9. We recommend reading below [migration guide](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#sibling-migration-guide) docs to find out how to address any breaking changes when upgrading the sibling SDKs.

##### Important

To prevent issues, use fixed versions of Sentry Capacitor and the Sibling SDK. Always install the Sibling SDK version that matches Sentry Capacitor.

## [Sibling migration guide](https://docs.sentry.io/platforms/javascript/guides/capacitor/migration/v1-to-v2.md#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](https://docs.sentry.io/platforms/javascript/guides/angular/migration/v8-to-v9.md).
* [React SDK 8.x to 9.x migration guide](https://docs.sentry.io/platforms/javascript/guides/react/migration/v8-to-v9.md).
* [Vue SDK 8.x to 9.x migration guide](https://docs.sentry.io/platforms/javascript/guides/vue/migration/v8-to-v9.md).
* [Nuxt SDK 8.x to 9.x migration guide](https://docs.sentry.io/platforms/javascript/guides/nuxt/migration/v8-to-v9.md).