Skip to content

Clarify rollout definitions for feature flags #2345

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
msiebert merged 4 commits into from
Feb 4, 2026
Merged

Clarify rollout definitions for feature flags #2345

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7fa37ff
Clarify rollout definitions for feature flags
msiebert Feb 2, 2026
3f549f5
fix misspelling
msiebert Feb 2, 2026
400424e
Trigger CI
msiebert Feb 3, 2026
b8da665
Merge branch 'main' into msiebert-rollout-clarification
msiebert Feb 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions pages/docs/featureflags.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,10 +25,11 @@ import { Cards, Callout, Steps } from 'nextra/components'
- **Variant Splits** — allocation across variants (e.g., 90%/10%).
- **Fallback Value** — variant to use when an assignment is unavailable.
- **Sticky Variants** — the same entity keeps the same variant over time.
- **Rollout Groups** - The configuration determining which users are in the rollout. This is comprised of:
- **Targeting** — eligibility definition (All Users vs Cohorts; may include runtime properties).
- **Rollout %** — percentage of the eligible audience that receives the flag now.
- **Rollout %** — percentage of the eligible Rollout Group that receives the flag now.
- **Rollout Groups** - the configuration determining which users are in the rollout. This is comprised of:
- **Filters** — the targeting configuration that determines whether a subject is eligible for this rollout. Filter types include Cohort and Runtime filters
- **Cohort Filter** - a targeting method that uses Mixpanel cohorts to target users
- **Runtime Filter** - a targeting method that checks data available at runtime against Runtime Property or Runtime Event configuration
- **Rollout %** — percentage of the audience that receives the flag if they are eligible for the rollout group
- **Runtime Properties** — request-time attributes (e.g., URL path, app version) used to target immediately.
- **Runtime Events** — event-based targeting (e.g., user clicked button, completed purchase) used to target users immediately after they perform actions.
- **Assignment vs Exposure** — assignment is deciding the variant; exposure is when your app **uses** that variant to render.
Expand Down