Flag dependencies define relationships between flags to ensure evaluation order. The result of each flag's evaluation is then passed to all subsequent evaluations to decide if dependent flags should evaluate based on the result of the dependency.
Flag dependencies help implement:
Available for flags and experiments.
Flag prerequisites is a generic implementation of flag dependencies that lets any flags or experiments depend on any other flags or experiments. Evaluation of the prerequisites can check specific variants or target users who weren't included in the prerequisite flag or experiment.
Use flag prerequisites to:
For more information, go to Flag Prerequisites
Available for experiments only.
A mutual exclusion group ensures that your users are only included in a single experiment. In Experiment, a mutual exclusion group defines multiple slots, each with a percentage of traffic allocated to that slot. The mutual exclusion group is actually just a flag with a variant for each slot. Experiments in the group add a dependency on one or more (variants) of the mutual exclusion group flag.
The variant result of a mutual exclusion group's evaluation isn't returned and isn't assigned as a user property.
For more information, go to Set up and run mutually exclusive experiments
Available for experiments only.
A holdout group withholds a percentage of traffic from a group of experiments. This allows measurement of the long-term and combined impact of multiple experiments. Experiment implements a holdout group using a flag with two variants: holdout
and on
. The holdout percentage that's defined when the group is created is allocated to the holdout
variant. Experiments in the group depend on the holdout group's variant on
.
The variant result of a holdout group's evaluation isn't returned. However, it's assigned as a user property to enable holdout analysis.
For more information, go to Holdout Groups.
Flag dependencies (mutual exclusion and holdout groups) is only supported after certain versions of Amplitude SDKs.
Prior local evaluation SDK versions don't consider mutual exclusion or holdout groups at all. In other words, two experiments in a mutual exclusion group evaluated with an old local evaluation SDK version aren't mutually exclusive.
SDK | Local Evaluation Flag Dependencies Support |
---|---|
Node.js | 1.4.0+ |
Ruby | 1.1.0+ |
JVM | 1.1.0+ |
Go | 1.1.0+ |
Python | 1.1.0+ |
PHP | 1.0.0+ |
June 18th, 2024
Need help? Contact Support
Visit Amplitude.com
Have a look at the Amplitude Blog
Learn more at Amplitude Academy
© 2025 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.