Feature Flags vs Entitlements: When to Use Which (and When You Need Both)
Should this checkbox in your UI be a feature flag or an entitlement? It's the question that derails more sprint planning sessions than it should.
Teams collapse the two into one toggle system and one of two things eventually breaks: billing gets tied to deploys, or risky releases hide inside your pricing layer. Neither is fun to undo.
Different lifecycle, different audience
A feature flag is a temporary, engineering-owned gate. Its job is to decouple deploy from release. The endpoint is the same for every flag: full rollout, then deletion.
An entitlementis a permanent, product-owned contract. It says "this account paid for this capability." It lives as long as the plan does and is owned by billing, pricing, and customer success — not the team that shipped the feature.
The cleanest tell: ask who flips it, and when does it go away?If engineering flips it and it disappears after rollout, it's a flag. If sales or billing flips it and it sticks around forever, it's an entitlement.
The two failure modes
Flag tool as entitlements system.You target the "advanced analytics" flag to plan tier and call it done. Six months later sales adds a new tier, three flags need updating in lockstep, and nobody remembers which is which. Pricing change becomes an engineering ticket.
Entitlements system as flag tool.You ship the new checkout behind an "experimental" entitlement, hand-toggled in your billing admin. Now your rollout strategy is whatever your CS team can click through, and a bad release means support tickets rather than a one-click kill switch.
When you need both — and how they compose
Most B2B SaaS features go through both gates. The flag protects the rollout; the entitlement protects the business model. Stack them, with the flag on the outside:
// Feature flag (engineering — temporary, rollout control)
const advancedAnalyticsReleased =
client.evaluate("advanced-analytics-release", "off") === "on";
// Entitlement (product — permanent, plan-based)
const planAllowsAdvanced = user.entitlements.includes("advanced-analytics");
if (advancedAnalyticsReleased && planAllowsAdvanced) {
renderAdvancedAnalytics();
}When the rollout is done, the flag disappears. The entitlement stays. The code keeps reading exactly the same way it would have if you'd shipped the feature day one.
Where Featureflow fits
You can pass plan tier into Featureflow as a user attribute and target on it — and for a short-lived beta of a paid feature, that's fine. But targeting rules that exist permanentlyto enforce pricing are a smell: they're an entitlements system in disguise, and they belong one layer up.
Keep flags in the flag tool. Keep entitlements in your subscription or billing layer. Let them compose at the call site.
The teams that get this right ship faster and price cleaner — because the two systems do the jobs they were built for, and neither has to fake the other.
Want a flag system that knows when to stay out of the entitlement layer? Start free at featureflow.com.
#FeatureFlags#Entitlements#B2BSaaS#ProductEngineering#ContinuousDelivery
Keep flags doing what flags do best
Featureflow gives engineering a clean rollout layer — so your entitlements system can stay focused on plans, not deploys.
Start Now (Free)Related Articles
Freeze the deploys, not the flags
A change freeze stops merges but not the flag dashboard. Freeze anything that adds risk, keep the switches that remove it, and enforce the rule with approvals.
Don't cache the answer to a feature flag
A cached page remembers the first visitor's flag, and your kill switch waits for the TTL. Evaluate per request and put the variant in the cache key.
What to put in the user you pass to a feature flag
The flag context starts as an id and ends up holding emails and names that no rule reads. Use an opaque id, pass only the attributes your rules compare, and build the user in one place.