Rollouts

A rollout is the rule that decides what value a flag returns for a given evaluation. flagctl supports three forms: percent, attribute match, and segment.

Percent splits

checkout.v2:
type: bool
default: false
rollout:
  production:
    strategy: percent
    value: 25

25% of users (by sticky hash) see true. The remaining 75% see the default.

Sticky bucketing

The bucket is hash(flagKey + userId) % 100. Once a user lands in a bucket, they stay there across requests — no need to persist the assignment.

Targeted segments

checkout.v2:
rollout:
  production:
    strategy: segment
    segments: [internal, beta-testers]

Segments are reusable user lists defined at the workspace level.