
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, switch to the *Reviews* tab and toggle this on.

{% figure %}
![Project settings reviews configuration interface](/images/guides/setting-up-reviews/45a439b5-7cf7-4f32-82d0-596c089f2359.png)
{% /figure %}

- You can optionally allow different roles to bypass the review requirement and self-approve review requests by customizing the permissions available to user roles:

{% figure %}
![User role permissions configuration screen](/images/guides/setting-up-reviews/4b7db056-a6be-4a76-99c9-08f8dc053ed8.png)
{% /figure %}

- When you make any configuration changes to a feature gate or experiment, the console prompts you to **Submit for Review**. You can add reviewers when you submit the change.

{% figure %}
<img src="/images/guides/setting-up-reviews/166678241-272adade-ca60-4942-bd04-a1413d54864c.png" alt="Submit for Review modal prompting for reviewer selection" width="1168" />
{% /figure %}

- Reviewers see a notification on the Statsig console. When they select **View Proposed Changes**, they see a diff of the _current version_ in production and the _new version_. Reviewers can then **Approve** or **Reject** the submitted changes.

{% figure %}
![proposed changes](/images/proposed_changes.png)
{% /figure %}

{% figure %}
![example review](/images/example_review_page.png)
{% /figure %}

## Teams

To create a predefined group of reviewers, you can create Teams.

{% figure %}
![Teams creation interface](/images/guides/setting-up-reviews/1b1c72a9-ac98-4590-8690-c39d2e68489a.png)
{% /figure %}

You can now use these predefined **Teams** when you submit any changes for review.

{% figure %}
![Team selection for review submission](/images/guides/setting-up-reviews/166684577-29598c7f-fcba-4c7e-848d-9a45b031bd79.png)
{% /figure %}

## Enforcing team reviews

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

For (a), refer to the **Turning on change reviews for a project** section to enable project-wide reviews. For (b), as an owner of a Feature Gate or Experiment, you can add designated **Teams** or **Reviewers** at any time. This ensures that only these designated groups or members can review and approve subsequent changes. When another member tries to edit these designated review groups or reviewers, the change requires approval from the currently designated reviewers.

{% figure %}
<img src="/images/guides/setting-up-reviews/166682283-c9e2de57-0b9a-473e-adf2-100a240ab6b0.png" alt="Team review configuration settings" width="655" />
{% /figure %}

{% figure %}
<img src="/images/guides/setting-up-reviews/166682177-d44411e6-c4ab-49fe-9250-c77b063621af.png" alt="Teams and reviewers selector for enforcing approvals" width="458" />
{% /figure %}

## Configuring review settings for different environments

Many teams build, test, and launch new features and experiments across multiple development environments. Statsig supports this through [Environments](/guides/using-environments#configuring-environments).

You can also configure which environments require reviews through **Project Settings**. Go to **Project Settings** → [**Keys & Environments**](https://console.statsig.com/BPJcDV1K1g87fTib5ZEMk/api_keys) → tap **Edit** on **Environments**.

By default, if you have enabled "Reviews Required" for your project, reviews are required for Production but not for non-Production environments.

{% figure %}
![Environments settings showing environments and order](/images/environments.png)
{% /figure %}

{% figure %}
![Manage environments dialog with environment list and review settings](/images/edit-environment-dialog.png)
{% /figure %}

#### Team-based required reviews per environment

You can assign specific teams as reviewers for each environment. This ensures that only designated team members can approve changes for that environment.

{% figure %}
![Assigning teams as reviewers for specific environments](/images/environment-reviews.png)
{% /figure %}

#### Code freeze use case

During code freeze periods, you can prevent anyone from deploying feature flags or configs to production by assigning a dedicated code freeze team as the production reviewer. This ensures that only members of that team (such as your SRE team or designated code freeze owners) can approve production changes. After the code freeze period ends, you can remove the team assignment to restore normal review workflows.
