Overview

Approvals help you control what changes are made to feature flags and by whom. In addition to granular access control, you can require approvals for changes to certain flags or production environments before those changes take effect.

Require approvals on an environment

1. Navigate to Feature Flags > Settings > Environments.
2. Select the environment you want to configure.
3. If it is not already a production environment, mark it as a production environment.
4. Enable the option to require approvals.

After you enable approvals, subsequent changes that impact application behavior in that environment require approval before they can be applied. The changes must be approved by another user with write access on the flag. Examples include:

• Enabling or disabling a flag
• Modifying targeting rules
• Archiving a flag

Require approvals on a feature flag

New flag

When creating a flag, toggle Require approval on changes to this flag for all production environments to enable approvals for that flag in every production environment.

Existing flag

1. Navigate to your flag’s details page.
2. Open Settings > Approvals.
3. Toggle Require approval on changes to this flag for all production environments.

Approval workflow

Submit changes for review

When you make a change that requires approval, a Submit Changes For Review modal appears. The modal prompts you to:

• Enter a description of the change
• Select a notification channel (for example, Slack or Microsoft Teams) for the approval request

To modify a pending change after submission, delete it and submit a new one.

Approve, reject, or apply

Approvers see a diff, a description of the change, and the affected environment. From the approval request, they can:

• Reject the change suggestion
• Approve the change suggestion without applying it
• Approve & apply the change in one step

Approving a change suggestion does not apply it. The approved change remains visible on the flag, and you can apply it at any time after approval.

Apply approved changes

After a change is approved, apply it when you are ready for it to take effect in the affected environment. You do not need to submit the change for review again.

Override approvals

The Feature Flag Approvals Override organization permission serves two purposes:

• Existing flags: Required to enable approvals for a flag that already exists (in addition to granular edit access on that flag).
• Workflow bypass: Allows holders to bypass the approvals workflow where that option is available, so changes can proceed without the usual review and approval steps.

Treat this permission as highly sensitive: assign it only to people who may need to change approval requirements or make exceptions to governance. Organization permissions are granted through Datadog roles. For related Feature Flags permissions, see Permissions and Access Control.

Find flags with pending approvals

On the Feature Flags search page, toggle the Pending Approvals filter to view flags with changes awaiting approval.

Further reading

Additional helpful documentation, links, and articles:

Permissions and Access ControlDOCUMENTATION EnvironmentsDOCUMENTATION