Targeting and Rollouts

​

Targeting Options

FlagSync offers flexible ways to roll out feature flags:

​

All Users

Serve a single variant to every user, ensuring a consistent experience with default settings. This approach relies on:

• Disabled Variant: Applied when the flag is off, serving as a fallback (e.g., “0% discount” for all).
• Enabled Variant: Applied when the flag is on, unless overridden by targeting or rollouts (e.g., “20% discount” for all).

​

User Segments

Target specific users by passing custom attributes via the SDK and defining rules in the dashboard to match those attributes. For example:

• Use Case: Create a rule to serve a beta feature to “QA Testers” and “PMs” while others see the baseline.
• Implementation: Provide attributes in the SDK—FlagSync auto-populates the rule creation UI with these attributes for targeting.

import { FlagSyncFactory } from '@flagsync/js-sdk';


const factory = FlagSyncFactory({

  sdkKey: 'your-sdk-key',

  core: {

    key: 'user123',

    attributes: { jobTitle: 'QA Tester', isVIP: false }

  }

});

​

Percentage Rollouts

Distribute variants by percentage to control rollout scope and risk. FlagSync simplifies this with:

• Allocation: Set splits (e.g., 25% each for four variants)—must total 100%.
• Use Case: Allow gradual releases—e.g., 10% rollout to test stability.

​

Next Steps

• Create a flag in Creating Flags.
• Learn about metrics in Metrics: Overview.
• Run experiments in Creating Experiment.