iOS

Install SDK

Qonversion iOS SDK is distributed as a Swift package and as a CocoaPod. Swift Package Manager is the recommended way to install it. The package offers two library products: Qonversion (the regular SDK — what a normal app adds) and QonversionNoIdfa (the same SDK without the IDFA reader, for apps in the Kids category — see Kids Mode); link exactly one of them.

Install via Swift Package Manager

Open Xcode (15 or newer), go to File → Add Package Dependencies…, paste the package URL into the search bar and add the Qonversion library to your app target:

https://github.com/qonversion/qonversion-ios-sdk

If you declare dependencies in Package.swift, add the package and the Qonversion product to your target:

dependencies: [
    .package(url: "https://github.com/qonversion/qonversion-ios-sdk.git", from: "6.17.0")
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "Qonversion", package: "qonversion-ios-sdk")
        ]
    )
]

Module names with Swift Package Manager

The Swift package exposes three modules, while the CocoaPod merges everything into a single Qonversion module:

You need	CocoaPods	Swift Package Manager
Core SDK (`Qonversion.shared()`, products, entitlements)	`import Qonversion`	`import Qonversion`
Swift-only API, for example `QonversionSwift.shared.syncStoreKit2Purchases()`	`import Qonversion`	`import QonversionSwift`
No-Codes (`NoCodes.shared`)	`import Qonversion`	`import NoCodes`

Which product you link (Qonversion or QonversionNoIdfa) does not change the imports.The QonversionSwift module holds every Swift-only API, not just syncStoreKit2Purchases() — the Qonversion.PurchaseOptions(quantity:contextKeys:screenUid:) Swift initializer used in Making purchases is there too. If a Swift-style initializer or method does not resolve under Swift Package Manager, add import QonversionSwift.

Install via CocoaPods

CocoaPods trunk becomes read-only on December 2, 2026. From that date new Qonversion releases will no longer be published to CocoaPods trunk — Swift Package Manager is the supported way to receive them; existing CocoaPods builds keep working. See the CocoaPods → Swift Package Manager migration guide.

Add the dependency to your Podfile:

pod 'Qonversion'

Run pod install in the project directory to download the dependency:

pod install

Kids Mode for Qonversion iOS SDK

In case you are building an App for Kids, add the QonversionNoIdfa package product (6.17.0+) or the Qonversion/NoIdfa pod instead — please, follow this guide to learn more 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.

Start here

Install the SDK

Choose your mode

Connect your stores

Migrate to Qonversion

Test and go live

Your project

Install SDK

Install via Swift Package Manager

Module names with Swift Package Manager

Install via CocoaPods

Kids Mode for Qonversion iOS SDK

Next steps

Analytics Mode

Subscription Management Mode

​Install SDK

​Install via Swift Package Manager

​Module names with Swift Package Manager

​Install via CocoaPods

​Kids Mode for Qonversion iOS SDK

​Next steps

Analytics Mode

Subscription Management Mode

Install SDK

Install via Swift Package Manager

Module names with Swift Package Manager

Install via CocoaPods

Kids Mode for Qonversion iOS SDK

Next steps