Skip to main content
A Feature Flag benefit is an entitlement record, not an external flag-service integration. Your application grants access whenever customer state contains the corresponding benefit grant.

​
Where this fits

Use one to distinguish subscription tiers, release a beta to selected buyers, choose an API quota tier, or unlock a premium product capability.

​
Configure the benefit

Open Products → Benefits, create a benefit of type Feature Flag, and give it a description your integration can identify. Optional metadata can carry values such as role: editor, max_upload_size: 10, or priority: elevated alongside the grant.

​
Read access state

Use Customer State for an immediate lookup and customer.state_changed to react to changes. Match the grant’s benefit identifier before enabling the corresponding feature. Recurring purchases grant access with the subscription lifecycle and remove it when that lifecycle ends. A one-time purchase grants ongoing access at purchase time.