iOS product analytics installation

PostHog is available through CocoaPods or as a Swift Package Manager dependency.

Install dependency

Required

Install via Swift Package Manager:

Package.swift
dependencies: [
  .package(url: "https://github.com/PostHog/posthog-ios.git", from: "3.0.0")
]

Or add PostHog to your Podfile:

Podfile
pod "PostHog", "~> 3.0"

Configure PostHog

Required

Initialize PostHog in your AppDelegate:

AppDelegate.swift
import Foundation
import PostHog
import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_: UIApplication, didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
        let POSTHOG_API_KEY = "<ph_project_token>"
        let POSTHOG_HOST = "https://us.i.posthog.com"

        let config = PostHogConfig(apiKey: POSTHOG_API_KEY, host: POSTHOG_HOST)
        PostHogSDK.shared.setup(config)

        return true
    }
}

Send events

Recommended

Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:

Swift
PostHogSDK.shared.capture("button_clicked", properties: ["button_name": "signup"])

Next steps

Recommended

Now that you're capturing events, continue with the resources below to learn what else Product Analytics enables within the PostHog platform.

Resource	Description
Capturing events	Learn how to capture custom events beyond autocapture
Identifying users	Associate events with specific users
Creating insights	Build trends, funnels, and retention charts
Group analytics	Track events at the company or account level

Swift Package Manager

Add PostHog as a dependency in your Xcode project Package Dependencies and select the project target for your app.

For Swift Package Manager projects, add PostHog to your Package.swift dependencies:

Package.swift
dependencies: [
  .package(url: "https://github.com/PostHog/posthog-ios.git", from: "3.0.0")
],

Then add it as a dependency for your target:

Package.swift
.target(
    name: "myApp",
    dependencies: [.product(name: "PostHog", package: "posthog-ios")]),

SwiftUI configuration

If you're using SwiftUI lifecycle, initialize PostHog in your app's init():

Swift
import SwiftUI
import PostHog

@main
struct YourGreatApp: App {
    init() {
        let POSTHOG_API_KEY = "<ph_project_token>"
        let POSTHOG_HOST = "https://us.i.posthog.com" // usually 'https://us.i.posthog.com' or 'https://eu.i.posthog.com'

        let config = PostHogConfig(apiKey: POSTHOG_API_KEY, host: POSTHOG_HOST)
        PostHogSDK.shared.setup(config)
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

For more advanced options, see the configuration page.