Skip to main content
Required comments are available to customers on select plansRequired comments are only available to customers on select plans. To learn more, read about our pricing. To upgrade your plan, contact Sales.
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.
Required comments are only enforced from the user interfaceWhen 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.

The "Save changes" dialog.

​
Require comments

To require comments in a new environment:
  1. Click the project dropdown. The project menu appears:
The project menu.

The project menu.

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

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

  1. 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:
The project menu.

The project menu.

  1. Select Project settings.
  2. Select Environments. The Environments list appears.
  3. 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, including the "Edit environment" option.

The environment overflow menu, including the "Edit environment" option.

  1. Select the Require comments for flag and segment changes checkbox.
  2. Click Save environment.
Comments on changes are now required for your environment.