Skip to main content

Setting up Reviews for Team Workflows

You can enable reviews for all Statsig resources such as feature gates, dynamic configs, segments, and experiments that you'll likely deploy to a production environment.

Turning on Change Reviews for a Project

As a Project Admin, you can configure your project to require reviews for any changes. To enable reviews for your project,

  • Navigate to the Project Settings page
  • Click on the Edit button next to Config Review Requirements

Screen Shot 2021-12-15 at 4 21 02 PM

  • Select Reviews Required from the drop down list
  • You can optionally allow yourself as a project admin to bypass the review requirement and self-approve review requests.

  • Now when you make any configuration changes, say to a feature gate or experiment, you'll be asked to Submit for Review; you can add reviewers when you submit the change for review

Screen Shot 2022-05-04 at 5 08 21 AM
  • Reviewers will now see see an alert on the Statsig console as shown below. When they click on View Proposed Changes, they will see a diff of the current version in production and new version. Reviewers can now Approve or Reject the submitted changes.

Screen Shot 2021-12-15 at 4 19 18 PM

Creating Review Groups

To create a predefined group of reviewers,

  • Navigate to the Basic SEttings tab under your Project Settings, and click the Create New Group button under Project Members and Groups

Screen Shot 2022-06-27 at 8 31 24 AM

  • Enter the name and members of the group and click Create.


  • You can now use these predefined Review Groups when you submit any changes for review.


Enforcing Team Reviews

You can a priori restrict who can make changes to your Project by (a) turning on Reviews Required for your Project and (b) adding designated Review Groups or Reviewers when you create the Feature Gate or Experiment.

For (a), see section Turning on Change Reviews for a Project to turn on project-wide reviews. For (b), as an owner of a Feature Gate or Experiment, you can add desginated Review Groups or Reviewers at any time as shown below. This ensures that only these designated groups or members can review and approve any subsequent changes. When another member now tries to edit these designated review groups/reviewers, this will require approval from currently desginated reviewers.

imageScreen Shot 2022-05-04 at 5 14 57 AM

Self-approvals for Admins

As a Project Admin, you can allow yourself and other Project Admins to self-approve review requests. To turn on this setting,

  • Navigate to the Project Settings page
  • Click on the Edit button next to Config Review Requirements
  • Click the checkbox to Allow Project Admins to self-approve reviews as shown below

Skipping reviews in dev and staging environments

If reviews are required on your project, you can add explicit sections for Development and Staging tier rules. These are identical to a rule that has a rule that includes an AND condition that specifies Environment Tier = Dev/Staging. Changes made to the explicit Dev/Staging tier rules do not require approval.