> ## 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/).
</Note>

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.
</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.">
  <img src="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" alt="The &#x22;Save changes&#x22; dialog." width="1240" height="1156" data-path="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.">
  <img src="https://mintcdn.com/launchdarkly/A4UXoRTW8ATNw4yq/images/auto/project-menu-dropdown.auto.png?fit=max&auto=format&n=A4UXoRTW8ATNw4yq&q=85&s=cb54f266bfd606cf1c307999121a40cb" alt="The project menu." width="576" height="364" data-path="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.">
  <img src="https://mintcdn.com/launchdarkly/-b7nPh0oyigf6iW7/images/auto/env-create-required-comments.auto.png?fit=max&auto=format&n=-b7nPh0oyigf6iW7&q=85&s=95af81ed6301e62b7ebf8a790dbf75c4" alt="The &#x22;Create an environment&#x22; panel with the &#x22;Require comments&#x22; checkbox called out." width="860" height="1346" data-path="images/auto/env-create-required-comments.auto.png" />
</Frame>

7. Click **Create environment**.

To learn more, read [Create environments](/docs/home/account/environment/create) and [Edit environment settings](/docs/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.">
  <img src="https://mintcdn.com/launchdarkly/A4UXoRTW8ATNw4yq/images/auto/project-menu-dropdown.auto.png?fit=max&auto=format&n=A4UXoRTW8ATNw4yq&q=85&s=cb54f266bfd606cf1c307999121a40cb" alt="The project menu." width="576" height="364" data-path="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.">
  <img src="https://mintcdn.com/launchdarkly/-b7nPh0oyigf6iW7/images/auto/environment-edit-environment.auto.png?fit=max&auto=format&n=-b7nPh0oyigf6iW7&q=85&s=6bb2c2235921bbb68136722566cedff7" alt="The environment overflow menu, including the &#x22;Edit environment&#x22; option." width="1896" height="1230" data-path="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.
