feature-flags

Feature Flags (FlagPole)

New features should be gated behind a feature flag.

1. Register the flag in src/sentry/features/temporary.py:

   manager.add("organizations:my-feature", OrganizationFeature, FeatureHandlerStrategy.FLAGPOLE, api_expose=True)
   

   Use api_expose=True if the frontend needs to check the flag. Use ProjectFeature and a projects: prefix for project-scoped flags.

2. Python check:

   if features.has("organizations:my-feature", organization, actor=user):
   

3. Frontend check (requires api_expose=True):

organization.features.includes('my-feature');

1. Tests:

   with self.feature("organizations:my-feature"):
       ...
   

2. Rollout: FlagPole YAML config lives in the sentry-options-automator repo, not here.

3. Removal: once the rollout is finished, the flag comes out in a fixed three-PR order — see the remove-option-or-flag skill.

See https://develop.sentry.dev/feature-flags/ for full docs.