

Amazon CodeCatalyst is no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [How to migrate from CodeCatalyst](migration.md).

# Categorizing work with labels
<a name="issues-labels"></a>

You can customize labels for issues. This includes editing the label and changing the color. Labels can help you categorize and organize your work. For example, you can create labels for specific aspects of your software, or for different groups or teams.

**Topics**
+ [Creating a label](#issues-create-label)
+ [Editing a label](issues-edit-label.md)
+ [Deleting a label](issues-delete-label.md)

## Creating a label
<a name="issues-create-label"></a>

In CodeCatalyst, you create labels by either adding them when you create a new issue or when you edit an existing issue. For more information, see [Creating an issue in CodeCatalyst](issues-create-issue.md) and [Editing and collaborating on issues in CodeCatalyst](issues-edit-collaborate-issue.md).

# Editing a label
<a name="issues-edit-label"></a>

Use the following procedure to change the name or color of an existing label.

**To edit a label**

1. In the navigation pane, choose **Issues**.

1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.

1. On the **Labels** tile is a list of the labels used in the project. Choose the edit icon next to the label that you want to edit. Do one or more of the following:

   1. Edit the name of the label.

   1. To change the color, choose the color wheel. Use the picker to choose a new color.

1. To save the changes you made to the label, choose the check mark icon.

1. The changed label is now visible in your list of available labels. You can also see how many issues are using that label.
**Note**  
You can choose the number displayed next to each label to navigate to the **All issues** page and see all issues that contain that label.

# Deleting a label
<a name="issues-delete-label"></a>

You cannot currently delete an issues label in CodeCatalyst. If you remove a label from all issues, the label will appear in the **Unused labels** section in the **Labels** section of issue **settings**. Unused labels appear at the end of the list of labels when using filters or adding labels to an issue. You can find an overview of all labels (used and unused) and issues that have them in the issue **settings**.