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

# Required comments

<View title="Developer" />

<View title="Federal docs" />

<View title="EU docs" />

> [!NOTE]
>
> **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/).

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]
>
> **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.](https://mintcdn.com/launchdarkly/WYiCaDy82H6mz_dK/images/auto/flag-save-with-comment.auto.png?fit=max\&auto=format\&n=WYiCaDy82H6mz_dK\&q=85\&s=3d09aea527d462aa78d9014762bb1423)

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.](https://mintcdn.com/launchdarkly/A4UXoRTW8ATNw4yq/images/auto/project-menu-dropdown.auto.png?fit=max\&auto=format\&n=A4UXoRTW8ATNw4yq\&q=85\&s=cb54f266bfd606cf1c307999121a40cb)

The project menu.

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:

![The "Create an environment" panel with the "Require comments" checkbox called out.](https://mintcdn.com/launchdarkly/-b7nPh0oyigf6iW7/images/auto/env-create-required-comments.auto.png?fit=max\&auto=format\&n=-b7nPh0oyigf6iW7\&q=85\&s=95af81ed6301e62b7ebf8a790dbf75c4)

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

7. Click **Create environment**.

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

To require comments in an existing environment:

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

![The project menu.](https://mintcdn.com/launchdarkly/A4UXoRTW8ATNw4yq/images/auto/project-menu-dropdown.auto.png?fit=max\&auto=format\&n=A4UXoRTW8ATNw4yq\&q=85\&s=cb54f266bfd606cf1c307999121a40cb)

The project menu.

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.

![The environment overflow menu, including the "Edit environment" option.](https://mintcdn.com/launchdarkly/-b7nPh0oyigf6iW7/images/auto/environment-edit-environment.auto.png?fit=max\&auto=format\&n=-b7nPh0oyigf6iW7\&q=85\&s=6bb2c2235921bbb68136722566cedff7)

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

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

Comments on changes are now required for your environment.
