Approval request settings

Overview

This topic explains how to customize the settings for your approval requests.

Approval settings

You can customize how approval requests are managed and enforced by making changes in an environment’s Approval settings.

For each environment, you can specify:

  • whether approvals are required for changes to flags or segments in the environment
  • whether requestors can approve their own requests
  • how many approvals are required before a requestor can apply a change
  • whether consensus is required, that is, whether the requestor can apply changes if any reviewers have declined a request

Members can approve and apply requests when they have the reviewApprovalRequest and applyApprovalRequest actions for flags or segments. These actions are part of the built-in Writer, Admin, and Owner roles. To learn more, read Custom roles.

Segment changes affect only the environment in which the segment is defined.

Some flag changes, like turning targeting on or off or changing targeting rules, affect the flag only at the environment level. Other flag changes, like editing flag variations, affect the flag at the project level. If you make a change to a flag variation that affects an environment with approvals required, then the change will trigger an approval request. To learn more, read How required approvals work for flag variations.

Enterprise customers can customize an environment’s approval settings in the “Edit environment” panel for that environment. To learn more, read Configuring approvals for an environment.

The following actions do not trigger an approval request:

  • Changing a flag’s name
  • Changing a flag’s maintainer
  • Changing a flag’s description
  • Changing a flag’s tags
  • Creating a flag
  • Archiving a flag
  • Deleting a flag
  • Changing a segment’s name
  • Changing a segment’s description
  • Changing a segment’s tags
  • Creating a segment
  • Deleting a segment

To prevent members from making these kinds of changes, you can configure and assign custom roles that deny these actions. To learn how, read Custom roles.