Skip to main content
GitHub release

​
Install via Cordova

Qonversion Plugin package is available on npm. Add it to your project with:
This downloads the package from npm and wires up the native iOS and Android modules in one step.

​
iOS requirements

Starting from plugin version 7.10.0 the native iOS dependency (QonversionSandwich and the Qonversion iOS SDK) is resolved through Swift Package Manager on cordova-ios 8 and through CocoaPods on older cordova-ios: The iOS deployment target must be 13.0 or higher. cordova-ios 8 uses 13.0 by default; on cordova-ios 6/7 add the preference to your config.xml, otherwise CocoaPods refuses to install the pod:
On cordova-ios 8 the CocoaPods tool must still be installed even though nothing is downloaded from it: cordova-ios keeps processing the plugin’s CocoaPods declarations, writes a Podfile without any pods and runs pod install.
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. Move to cordova-ios 8 before then — see the migration guide.

​
Troubleshooting

  • CocoaPods was not found during cordova plugin add or cordova build — install CocoaPods (sudo gem install cocoapods or brew install cocoapods). On cordova-ios 8, if the plugin was added while CocoaPods was missing, re-add the iOS platform (cordova platform rm ios && cordova platform add ios) rather than only the plugin, otherwise Xcode reports Conflicting identity for cordova-plugin.
  • The platform of the target ... (iOS 11.0) is not compatible with QonversionSandwich on cordova-ios 6/7 — add the deployment-target preference above and run cordova platform rm ios && cordova platform add ios.
  • A Qonversion pod declared in your own Podfile — remove it: the sandwich pins the native SDK exactly, a second copy produces duplicate symbols.

​
Kids Mode for Qonversion Cordova 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.