iOS product analytics installation

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

Install via CocoaPods

Required

Add PostHog to your Podfile:

Podfile
pod "PostHog", "~> 3.0"

Or install via Swift Package Manager:

Package.swift
dependencies: [
  .package(url: "https://github.com/PostHog/posthog-ios.git", from: "3.0.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_api_key>"
        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"])

By default, for backwards compatibility reasons, events are sent with person profile processing enabled. This means a person profile will be created for each user who triggers an event.

If you want to disable person profile processing for certain events, send the event with the following property:

Swift
"$process_person_profile": false

Next steps

Recommended

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_api_key>"
        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.