> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Required comments

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

> For the complete documentation index, see [llms.txt](/llms.txt). For the full documentation snapshot, see [llms-full.txt](/llms-full.txt).

<Note title="Required comments are available to customers on select plans">
  Required comments are only available to customers on select plans. To learn more, [read about our pricing](https://launchdarkly.com/pricing/). To upgrade your plan, [contact Sales](https://launchdarkly.com/contact-sales/).
</Note>

## 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.

<Warning title="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.
</Warning>

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

<Frame caption="The &#x22;Save changes&#x22; dialog.">
  ![The "Save changes" dialog.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/581f5694b16db7108f8861d25f41290c9a93c889bcee398038451139d33ff610/assets/images/auto/flag-save-with-comment.auto.png)
</Frame>

## Require comments

To require comments in a new environment:

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

<Frame caption="The project menu.">
  ![The project menu.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/b0dbb7934c69e875ae14bdb12a880ae2b7d28030b397db14e553fe9709d74fcc/assets/images/auto/project-menu-dropdown.auto.png)
</Frame>

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:

<Frame caption="The &#x22;Create an environment&#x22; panel with the &#x22;Require comments&#x22; checkbox called out.">
  ![The "Create an environment" panel with the "Require comments" checkbox called out.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/0e1587027c11070b1f5ff63fb42b55cc330caf9daff8fae6241c91fa9fa22992/assets/images/auto/env-create-required-comments.auto.png)
</Frame>

7. Click **Create environment**.

To learn more, read [Create environments](/home/account/environment/create) and [Environment settings](/home/account/environment/settings).

To require comments in an existing environment:

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

<Frame caption="The project menu.">
  ![The project menu.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/b0dbb7934c69e875ae14bdb12a880ae2b7d28030b397db14e553fe9709d74fcc/assets/images/auto/project-menu-dropdown.auto.png)
</Frame>

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.

<Frame caption="The environment overflow menu, including the &#x22;Edit environment&#x22; option.">
  ![The environment overflow menu, including the "Edit environment" option.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/b82028eaab953ec023063c5851d4a526b8bd2ee3417d8eff56cc549319d5c4ac/assets/images/auto/environment-edit-environment.auto.png)
</Frame>

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

Comments on changes are now required for your environment.