iOS Product Analytics installation

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

Install with the wizard

Run this command in your project directory to add PostHog to your iOS project. The wizard detects your framework, installs the SDK, and sets up your first events.

Learn more

Or set it up manually by following the rest of this guide.

Install dependency

Required

Install via Swift Package Manager:

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

Or add PostHog to your Podfile:

Podfile
pod "PostHog", "~> 3.56"

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_PROJECT_TOKEN = "<ph_project_token>"
        let POSTHOG_HOST = "https://us.i.posthog.com"

        let config = PostHogConfig(projectToken: POSTHOG_PROJECT_TOKEN, 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

For Swift Package Manager, UIKit, SwiftUI, and advanced configuration examples, see the iOS SDK installation guide and configuration page.