references/android.md
AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
Android Feature Flags installation
Canonical URL: https://posthog.com/docs/feature-flags/installation/android
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 the 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 Android 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 the dependency
Required
Add the PostHog Android SDK to your
build.gradledependencies:build.gradle
dependencies { implementation("com.posthog:posthog-android:3.+") } -
2
Configure PostHog
Required
Initialize PostHog in your Application class:
SampleApp.kt
class SampleApp : Application() { companion object { const val POSTHOG_PROJECT_TOKEN = "<ph_project_token>" const val POSTHOG_HOST = "https://us.i.posthog.com" } override fun onCreate() { super.onCreate() // Create a PostHog Config with the given project token and host val config = PostHogAndroidConfig( apiKey = POSTHOG_PROJECT_TOKEN, host = POSTHOG_HOST ) // Setup PostHog with the given Context and Config PostHogAndroid.setup(this, config) } } -
3
Send events
Recommended
Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:
Kotlin
import com.posthog.PostHog PostHog.capture( event = "button_clicked", properties = mapOf( "button_name" to "signup" ) ) -
4
Evaluate boolean feature flags
Required
Check if a feature flag is enabled:
Kotlin
val isMyFlagEnabled = PostHog.isFeatureEnabled("flag-key") if (isMyFlagEnabled) { // Do something differently for this user // Optional: fetch the payload val matchedFlagPayload = PostHog.getFeatureFlagResult("flag-key")?.payload } -
5
Evaluate multivariate feature flags
Optional
For multivariate flags, check which variant the user has been assigned:
Kotlin
val enabledVariant = PostHog.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 val matchedFlagPayload = PostHog.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 |