Skip to main content
GitHub release

​
Install via npm

Qonversion Plugin package is available on npm.
After installing, sync the plugin into your iOS and Android projects so the native code is wired up:

​
iOS native dependencies

Starting from plugin version 1.9.0 the plugin ships both a Package.swift and a podspec, so npx cap sync resolves the native dependency (QonversionSandwich and the Qonversion iOS SDK) with whichever package manager your iOS project uses:
  • Swift Package Manager — the default for iOS projects created with Capacitor 8 (npx cap add ios). On Capacitor 7 create the project with npx cap add ios --packagemanager SPM. No CocoaPods installation is needed.
  • CocoaPods — iOS projects created with npx cap add ios --packagemanager CocoaPods on Capacitor 8, or with the default template on Capacitor 7 and older. npx cap sync runs pod install for you.
The plugin supports Capacitor 7 and 8 (@capacitor/core 7.x or 8.x) and declares iOS 14.0 as its minimum deployment target.
CocoaPods trunk becomes read-only on December 2, 2026: new versions of the native Qonversion SDK will no longer be published to CocoaPods trunk — the Swift Package Manager path is the supported way to receive them; existing CocoaPods builds keep working. To move an existing CocoaPods-based iOS project to Swift Package Manager, use Capacitor’s assistant — npx cap spm-migration-assistant (it warns about plugins without a Swift package, see Capacitor’s Swift Package Manager guide) — and see the migration guide.
If your Podfile or Package.swift also declares the native Qonversion SDK directly, remove it: the sandwich pins the native SDK exactly, a second copy produces duplicate symbols or a package resolution conflict.

​
Kids Mode for Qonversion Capacitor Plugin

In case you are building an App for Kids, follow this guide to learn about Kids Mode for Qonversion SDKs.

​
Next steps

The SDK is installed. Choose the mode to implement — this determines how much code you write next.

Analytics Mode

Get best-in-class subscription analytics without changing your purchase flow — the fastest way to start.

Subscription Management Mode

Let Qonversion fetch products, make purchases, and manage cross-platform access.