iOS Feature Flags

Supported on: iOS SDK 1.0.61+

The feature flags module lets you enable or disable features remotely from the AppDNA Console. Flags are evaluated locally from cached config — no network call, no latency.

Check a Flag

if AppDNA.features.isEnabled("dark_mode") {
    enableDarkMode()
}

isEnabled() returns false by default if the flag does not exist or config has not loaded.

What counts as enabled

A flag’s stored value is not always a boolean — the server treats a string-typed flag as first-class — so isEnabled() coerces, identically on both platforms:

Stored value	`isEnabled()`
a boolean	that boolean
a number	`true` when it is non-zero
a string	`true` for `true`, `1`, `yes` or `on` — trimmed and case-insensitive; anything else is `false`
missing, or any other type	`false`

Use getVariant() when you need the raw value rather than this coercion — a string flag carrying a variant name, for example, where isEnabled() would answer false for every name that is not one of the four above.

Module Access

let features = AppDNA.features

Module Methods

Method	Signature	Description
`isEnabled`	`isEnabled(_ flag: String) -> Bool`	Check if a feature flag is enabled
`getVariant`	`getVariant(_ flag: String) -> Any?`	Get the variant value for a flag

Using Flags with Experiments

Feature flags and experiments work together. A common pattern is to gate a feature behind a flag, then run an experiment to test its impact:

// Flag controls whether the feature is available at all
if AppDNA.features.isEnabled("new_workout_ui") {
    // Experiment controls which variant of the feature to show
    let variant = AppDNA.experiments.getVariant("workout_ui_test")

    switch variant {
    case "compact":
        showCompactWorkoutUI()
    case "detailed":
        showDetailedWorkoutUI()
    default:
        showDefaultWorkoutUI()
    }
} else {
    showLegacyWorkoutUI()
}

Listen for Flag Changes

Register a closure that is called on the main thread once after every successful config fetch — at configure, when the config TTL expires, and on AppDNA.remoteConfig.refresh() — whether or not a flag changed. Re-read the flags you care about:

AppDNA.features.onChanged {
    // Feature flags were updated
    let isPremium = AppDNA.features.isEnabled("premium_features")
}

Full Example

import AppDNASDK

class FeatureGate {
    func checkAccess(feature: String, onLocked: () -> Void, onUnlocked: () -> Void) {
        if AppDNA.features.isEnabled(feature) {
            onUnlocked()
        } else {
            onLocked()
        }
    }
}

// Usage
let gate = FeatureGate()

gate.checkAccess(feature: "ai_suggestions",
    onLocked: {
        // Show upgrade prompt or paywall
        AppDNA.paywall.present("premium_paywall", from: self, context: PaywallContext(placement: "feature_gate"))
    },
    onUnlocked: {
        showAISuggestions()
    }
)

Feature flags are managed in the Console under Settings > Feature Flags. Toggle a flag on or off and it takes effect on the next SDK config refresh — when the TTL elapses (default 1 hour), or immediately if you call AppDNA.remoteConfig.refresh() / AppDNA.forceRefreshConfig(), which bypass the TTL. iOS runs no background fetch, so without one of those calls the TTL is the whole story.

​Check a Flag

​What counts as enabled

​Module Access

​Module Methods

​Using Flags with Experiments

​Listen for Flag Changes

​Full Example

Check a Flag

What counts as enabled

Module Access

Module Methods

Using Flags with Experiments

Listen for Flag Changes

Full Example