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.15.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.

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.

Overview

Get Started

Testing

Features

No-Code Builder

Remote Config

Experiments

Platform Resources

Stores Setup

SDK Migration Guides

AI-Ready

API Reference Guide

API Reference Guide v4

Install SDK

Install via Swift Package Manager

Module names with Swift Package Manager

Install via CocoaPods

Kids Mode for Qonversion iOS SDK

Next steps

​Install SDK

​Install via Swift Package Manager

​Module names with Swift Package Manager

​Install via CocoaPods

​Kids Mode for Qonversion iOS SDK

​Next steps

Install SDK

Install via Swift Package Manager

Module names with Swift Package Manager

Install via CocoaPods

Kids Mode for Qonversion iOS SDK

Next steps