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).
# Organizing work with backlogs, labels, and boards
Not all teams work in the same way. You can configure the way issues appear and can be assigned in Amazon CodeCatalyst to help you precisely understand what's being worked on and the status of that work. You can choose what estimation method to allow for issues so that your users all use the same estimation method. You can create cusotm labels and statuses which can also be used to filter the view of the work. Depending on how your team works, you can configure whether to allow multiple assignees for an issue, or only allow an issue to be assigned to a single user. You can also create custom views of issues so that work is displayed in a way that shows the most relevant information to you or your team.
# Categorizing work with labels
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
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
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
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**.
# Organizing work with custom fields
You can create custom fields to help organize and view the work for your project. Custom fields are added to the list of available filters in **Filter** so you can filter issues by custom fields. Custom fields are name and value pairs. You filter by the name of the custom field, and then the value of that custom field.
An issue can have multiple custom fields.
## Creating a custom field
In CodeCatalyst, you create custom fields by either adding them when you create an 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).
## Deleting a custom field
To delete a custom field, you must remove the custom field from each issue it is added to. When a custom field is deleted, you will no longer see the custom field in **Filter**. You can use filters to view all issues with a custom field, and remove them by editing the issues. For more information, see [Finding and viewing issues](issues-view.md) and [Editing an issue](issues-edit-issue.md)
# Tracking work with custom statuses
You can add custom statuses on your board. Each custom status must belong to one of the following categories: **Draft**, **Not started**, **Started**, or **Completed**. Status categories are used to help organize statuses and populate default views. For more information about statuses and status categories, see [Status and status categories](issues-concepts.md#issues-concepts-status-definition) and for more information about views, see [Finding and viewing issues](issues-view.md).
# To create a status
1. In the navigation pane, choose **Issues**.
1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.
1. In **Statuses**, choose the plus icon next to the category you want the status to be in.
1. Name the status, then choose check mark icon.
**Note**
Choose the X icon to cancel adding a status.
The custom status is now visible on your board and shows as an option when creating an issue.
# To edit a status
1. In the navigation pane, choose **Issues**.
1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.
1. In **Statuses**, choose the edit icon next to the status you want to edit or change.
1. Edit the status, then choose the check mark icon.
The edited status is now visible on your board.
# To move a status
1. In the navigation pane, choose **Issues**.
1. Choose the ellipsis icon and choose **Settings**.
1. In **Statuses**, choose a status you want to move.
1. Drag and drop the status where you want it to be.
**Note**
You can only move a status within its designated category.
The statuses are now reordered on your board.
# To deactivate a status
1. In the navigation pane, choose **Issues**.
1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.
1. In **Statuses**, choose a status you want to deactivate.
1. On the status you want to deactivate, choose the toggle on the status. The status is now grayed out.
**Note**
The deactivated status appears on the board until all issues are moved out of it. Issues cannot be added to a deactivated status.
1. To reactivate a deactivated status, choose the toggle on the status. The status is no longer grayed out.
**Note**
There must be at least one active status in each category. If there is only one status in the category, you cannot deactivate it.
# Configuring issue effort estimation
Follow these steps to configure the setting for effort estimations for issues in CodeCatalyst.
**To configure effort estimation for issues**
1. In the navigation pane, choose **Issues**.
1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.
1. In **Estimation** in the **Basic settings** section, choose how the estimation values will be displayed. The types of estimates available are **T-shirt sizing**, **Fibonacci sequencing**, or **Hide estimates**. When the estimation type is updated, no data will be lost and the estimation value of all issues will be converted automatically. The conversion mapping is shown in the following table.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/codecatalyst/latest/userguide/issues-settings-estimation.html)
# Enabling or disabling multiple assignees
Follow these steps to configure the setting for multiple assignees for issues in CodeCatalyst.
**To enable or disable multiple assignees**
1. In the navigation pane, choose **Issues**.
1. Choose **Active issues** to open the **issues view switcher** dropdown menu and choose **Settings**.
1. In **Assignee** in the **Basic settings** section, toggle the indicator to enable multiple assignees to be assigned to the same issue. An issue can have up to 10 assignees. If you do not enable this option, you will only be able to assign one assignee to an issue.
# Creating an issues view
You can create [views](issues-concepts.md#issues-concepts-views-definition) to quickly view issues that match a particular set of filters. This can help you save time and quickly view issues you have previously filtered, grouped, or sorted by.
**To create an issues view**
1. In the navigation pane, choose **Issues**.
1. (Optional) Depending on your use case, you may want to create a view from an existing view. To navigate to a different view, choose **Active issues** to open the **issues view switcher** dropdown menu and choose the view.
1. (Optional) Configure filters, grouping, and sorting before you create your view. You can add these while creating a view, but if you do it before, you can preview what is shown in the view before creating it.
1. Open the **issues view switcher** dropdown menu from the header bar. To create a board view where issues are viewed in columns based on status, choose the **\$1** in the **Board** column. To create a grid view where issues are viewed in a list, choose the **\$1** in the **Grid** column. You can change the type of view before it is created if you change you mind.
1. In the **Create view** dialog box, enter a **Name** for the view.
1. The **Filters**, **Group issues by**, and **Sort issues by** fields are filled based on the settings of the current view. Update them if necessary.
1. Choose **Create view** to create the view and be switched to it.