Required comments

Read time: 3 minutes

Last edited: May 01, 2024

Required comments is an Enterprise feature

Required comments is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

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

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

Required comments are only enforced from the user interface

When Require comments is enabled, members must leave a comment to explain their changes when they make changes from the flags list or the segments list in the LaunchDarkly user interface (UI). Comments are not required for changes made with the LaunchDarkly API.

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

The "Save changes" dialog with the "Comment" field called out.

Require comments

To require comments on flag changes in a new environment:

Click the project dropdown. The project menu appears:

Select Environments. The Environments list appears.
Click Create environment. The "Create an environment" panel appears.
Give your environment a human-readable Name.
Select the Require comments for flag and segment changes checkbox:

The "Create an environment" panel with the "Require comments" checkbox called out.

Click Create environment.

To learn more, read Create environments.

To require comments in an existing environment:

Click the project dropdown. The project menu appears:

Select Environments. The Environments list appears.
Next to the environment you want to edit, click the overflow menu and choose Edit environment. The Edit environment panel appears:

The environment overflow menu with the "Edit environment" option called out.

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

Comments on flag changes are now required for your environment.