references/ios.md
AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
iOS Feature Flags installation
Canonical URL: https://posthog.com/docs/feature-flags/installation/ios
Cloud region: This page uses US Cloud hosts. For an EU Cloud project, use
https://eu.i.posthog.cominstead ofhttps://us.i.posthog.com(ingestion host).
On this page
- Install with the wizard
- Install dependency
- Configure PostHog
- Send events
- Evaluate boolean feature flags
- Evaluate multivariate feature flags
- Running experiments
- Next steps
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.
npx @posthog/wizard
Or set it up manually by following the rest of this guide.
-
1
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" -
2
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 } } -
3
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"]) -
4
Evaluate boolean feature flags
Required
Check if a feature flag is enabled:
Swift
let isMyFlagEnabled = PostHogSDK.shared.isFeatureEnabled("flag-key") if isMyFlagEnabled { // Do something differently for this user // Optional: fetch the payload let matchedFlagPayload = PostHogSDK.shared.getFeatureFlagResult("flag-key")?.payload } -
5
Evaluate multivariate feature flags
Optional
For multivariate flags, check which variant the user has been assigned:
Swift
let enabledVariant = PostHogSDK.shared.getFeatureFlag("flag-key") if enabledVariant == "variant-key" { // replace 'variant-key' with the key of your variant // Do something differently for this user // Optional: fetch the payload let matchedFlagPayload = PostHogSDK.shared.getFeatureFlagResult("flag-key")?.payload } -
6
Running experiments
Optional
Experiments run on top of our feature flags. Once you've implemented the flag in your code, you run an experiment by creating a new experiment in the PostHog dashboard.
-
7
Next steps
Recommended
Now that you're evaluating flags, continue with the resources below to learn what else Feature Flags enables within the PostHog platform.
| Resource | Description | | --- | --- | | Creating a feature flag | How to create a feature flag in PostHog | | Adding feature flag code | How to check flags in your code for all platforms | | Framework-specific guides | Setup guides for React Native, Next.js, Flutter, and other frameworks | | How to do a phased rollout | Gradually roll out features to minimize risk | | More tutorials | Other real-world examples and use cases |