Skip to content

Frequently asked questions

Functionality and support

How can I join the feature flags beta program?

Braze feature flags are currently in an open beta. Please ask your Braze account team to learn more about joining the beta program.

What platforms are Braze feature flags supported on?

Braze supports Feature Flags on iOS, Android, and Web platforms with the following SDK version requirements:

Do you need support on other platforms? Email our team: [email protected].

What is the level of effort involved when implementing a feature flag?

A feature flag can be created and integrated in a few minutes.

Most of the effort involved will be related to your engineering team building the new feature you plan to roll out. But when it comes to adding a feature flag, it’s as simple as an IF/ELSE statement in your app or website’s code:

import { getFeatureFlag } from "@braze/web-sdk";

if (getFeatureFlag("new_shopping_cart").enabled) {
    // Show the new homepage your team has built
else {
    // Show the old homepage

How can feature flags benefit Marketing teams?

Marketing teams can use feature flags to coordinate product announcements (such as product launch emails) when a feature is only enabled for a small percentage of users.

How can feature flags benefit Product teams?

Product teams can use feature flags to perform gradual rollouts or soft launches of new features in order to monitor key performance indicators and customer feedback before making it available to all users.

Product teams can use feature flag properties to remotely populate content in an app, such as deep links, text, imagery or other dynamic content.

How can feature flags benefit Engineering teams?

Engineering teams can use feature flags to reduce the risk inherent in launching new features, and avoid rushing to deploy code fixes in the middle of the night.

By releasing new code hidden behind a feature flag, your team can turn the feature on or off remotely from the Braze dashboard, bypassing the delay of pushing out new code or waiting for an app store update approval.

Feature rollouts and targeting

Can a feature flag be rolled out to only a select group of users?

Yes, simply create a segment in Braze that targets specific users—by email address, user_id, or any other attribute on your user profiles. Then, deploy the feature flag for to 100% of that segment.

How does adjusting the rollout percentage affect users who were previously bucketed into the enabled group?

Feature flag rollouts remain consistent for users, across devices and sessions.

  • When a feature flag is rolled out to 10% of random users, that 10% will remain enabled and persist for the lifetime of that feature flag.
  • If you increase the rollout from 10% to 20%, the same 10% will remain enabled, plus a new, additional 10% of users will be added to the enabled group.
  • If you lower the rollout from 20% back down to 10%, only the original 10% of users will remain enabled.

This strategy helps ensure that users are shown a consistent experience in your app, and don’t flip-flop back and forth across sessions. Of course, disabling a feature down to 0% will remove all users from the feature flag, which is helpful in case you discover a bug or need to disable the feature altogether.

Can I create a segment of users who are currently in a feature flag?

This is on our product roadmap. To help prioritize this, please raise this feedback with your Braze account team, or email our team: [email protected].

Technical topics

Can feature flags be used to control when the Braze SDK is initialized?

No, the SDK must be initialized in order to download and synchronize feature flags for the current user. This means you can’t use feature flags to limit which users are created or tracked in Braze.

How frequently are feature flags refreshed by the SDK?

Feature flags are refreshed at session start and when changing active users. Feature flags can also be manually refreshed using the SDK’s refresh method.

Keep in mind that good data practices recommend not refreshing feature flags too quickly (with potential rate limiting if done so), so it’s best to only refresh before a user interacts with new features or periodically in the app if necessary.

Are feature flags available while a user is offline?

Yes, once feature flags are refreshed they are stored locally on the user’s device and can be accessed while offline.

What happens if feature flags are refreshed mid-session?

Feature flags may be refreshed mid-session. There are scenarios where you may want to update your app if certain variables or your configuration should change. There are other scenarios where you may not want to update your app, so as to avoid a shocking change in how your UI is rendered.

To control this, listen for updates to feature flags and make the determination to re-render your app or not based on which feature flags have changed.


Have questions or feedback? Email our team: [email protected].

New Stuff!