define feature-flag --plain-english

Illustration for "Feature Flag" from the Non-Technical Technical Dictionary

Feature Flag

TLDR:The safest way to ship a risky feature is to ship it turned off, then flip it on for ten people and watch.

The safest way to ship a risky feature is to ship it turned off, then flip it on for ten people and watch.

A feature flag is a switch inside your live app that turns a feature on or off without shipping new code. The feature ships dark. It's built and sitting there, invisible, and you flip it on whenever you want, for whoever you want.

The dimmer switch. A normal light switch is on or off, and rewiring it means cutting the power and calling an electrician (that's a redeploy). A feature flag is a dimmer you wired in before launch. Now you can bring the new feature up to 10% of the room, watch for sparks, ease it to 50%, and if anything smells like burning, drop it to zero instantly. No electrician, no cutting the power, no redeploy. The wiring's already in the wall. You're just turning the knob.

What that knob unlocks, and why real teams live on it:

  1. Gradual rollout. Turn the feature on for 1% of users, then 10%, then everyone, watching at each step. If it breaks, only a sliver of people ever saw it.

  2. An instant off switch. Something goes wrong, you flip the flag, it's gone, faster even than a rollback, because you're not redeploying anything, just toggling. A rollback puts the whole app back a version. A flag kills one feature and leaves everything else untouched.

  3. Shipping unfinished work safely. The team can fold half-built features into the real app behind an off flag, instead of hoarding them on a branch for months. It's there. It's just dark until it's ready.

  4. Showing different people different things. The flag can be on for your team and off for customers, or on for beta users only. Same app, different doors open for different people.

See how it sits alongside the last two ideas. Staging rehearses before the audience ever arrives. A rollback undoes the whole show fast once they're in. A feature flag is finer than both. It lets you ship to the live audience but control exactly who sees the new act, and yank it without ever closing the theater.

So "put it behind a flag" decoded is: ship it, but wire in an off switch so we control who sees it and can kill it the instant it's bad. It's how teams ship scary things without holding their breath.

One honest note. Flags pile up. Every dimmer you wire in and forget is a little clutter in the walls. Teams that lean on flags also clean out the dead ones, because a flag for a feature that's now just permanently on is only confusing wiring.

A feature flag is a dimmer you wire in before launch. Ship it dark, bring it up for ten people, and kill it with a knob. No electrician required.