Skip to content
Fallow home
All docs pages

Docs home

Flag retirement candidate

What a flag-retirement-candidate finding of fallow flags means, why it matters and how to fix it.

What it reports

Feature flag is a retirement candidate.

Feature flags explains how fallow finds it.

Why it matters

The flag no longer switches real behavior, but its branches stay in the code. Readers and tests keep both paths alive, and a dead path can come back on with a wrong flag value.

Example

FEATURE_NEW_CHECKOUT has one read site, and --flag-state shows that the vendor rolled the flag out to all users.

Fix

Confirm with the owner of the flag that the rollout is done. Remove the flag check, keep the branch that production runs, delete the other branch, then remove the flag from the vendor.

Facts

FactValue
Issue typeflag-retirement-candidate
Rule id in SARIF outputfallow/flag-retirement-candidate
Commandfallow flags
Fixable with fallow fixNo