Required comments

Overview

This topic explains how to use required comments for feature flag and segment changes.

Comments help establish a change history for a flag or segment. Requiring members to leave comments when they change flags or segments helps your organization understand why flags or segments look and behave certain ways.

When you require comments in an environment, members must leave a comment when saving any changes to a flag:

Require comments

To require comments in a new environment:

1. Click the project dropdown. The project menu appears:

2. Select Project settings.
3. Select Environments. The Environments list appears.
4. Click Add environment. The “Create an environment” panel appears.
5. Give your environment a human-readable Name.
6. Select the Require comments for flag and segment changes checkbox:

7. Click Create environment.

To learn more, read Create environments and Edit environment settings.

To require comments in an existing environment:

1. Click the project dropdown. The project menu appears:

2. Select Project settings.
3. Select Environments. The Environments list appears.
4. Next to the environment you want to edit, click the overflow menu and choose Edit environment. The Edit environment panel appears.

5. Select the Require comments for flag and segment changes checkbox.
6. Click Save environment.

Comments on changes are now required for your environment.