Testing your feature flag

Last updated:

|Edit this page

Once you've written your code, it's a good idea to test that each variant behaves as you'd expect. There are 3 ways you can do this:

Method 1: Assign a user a specific flag value

For boolean flags, you can roll out the flag to a specific user. For multivariate flags, you can assign a user to a specific variant by adding an optional override to your release conditions.

To do this:

  1. Go to your feature flag.

  2. Ensure the feature flag is enabled by checking the "Enable feature flag" box.

  3. Add a new condition set with the condition to email = your_email@domain.com. Set the rollout percentage for this set to 100%.

    • in cases where email is not available (such as when your users are logged out), you can use a parameter like utm_source and append ?utm_source=your_variant_name to your URL.
  1. If it is a multivariant flag, set the optional override to the variant you want to assign these users to.
  2. Click "Save".

Method 2: Use posthog.featureFlags.overrideFeatureFlags()

Note: The posthog.featureFlags.overrideFeatureFlags() method is only available in the JavaScript web and React Native SDKs.

You can add a manual override directly in your code by calling posthog.featureFlags.overrideFeatureFlags():

JavaScript
posthog.featureFlags.overrideFeatureFlags( {
flags: {
'your_boolean_feature_flag_key': true // for boolean feature flags
'your_multivariate_feature_flag_key': 'your_variant_name', // for multivariate feature flags
}
})

Method 3: Use the PostHog toolbar

Note: The PostHog toolbar is only available for the JavaScript web SDK.

The toolbar enables you to test your feature flags. You can enable, disable, or override your feature flags, and then view how your website or app changes with the new feature flags values.

To do this, click on the "Feature Flags" button in the toolbar, search for any feature flag, and click on the toggles to change its value.

Overriding feature flags will only affect your browser. You may also need to refresh the page to see how your change affect your website. It does not affect feature flags evaluation for your backend.

Questions? Ask Max AI.

It's easier than reading through 592 docs articles.

Community questions

Was this page useful?

Next article

Feature flag best practices

1. Use a reverse proxy Ad blockers have the potential to disable your your feature flags, which can lead to bad experiences, such as users seeing the wrong version of your app, or missing a new feature rollout. To avoid this, deploy a reverse proxy, which enables you to make requests and send events to PostHog Cloud using your own domain. This means that requests are less likely to be intercepted by tracking blockers, and your feature flags are more likely to work as intended. You'll also…

Read next article