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

# Finding and viewing issues
<a name="issues-view"></a>

The following sections describe how to effectively search for and view issues within a CodeCatalyst project.

## Searching for an issue
<a name="issues-search"></a>

 You can find an issue by searching for specific parameters. For more information about refining your search, see [Search for code, issues, projects, and users in CodeCatalystSearch for code, issues, projects, and users](search.md).

**To search for an issue**

1. Navigate to your project.

1. Use the search bar to search for issues or information related to issues. You can use query parameters to refine your search. For more information, see [Search for code, issues, projects, and users in CodeCatalystSearch for code, issues, projects, and users](search.md).

# Sorting issues
<a name="issues-sorting"></a>

By default, issues in CodeCatalyst are sorted by **Manual order**. Manual order displays issues in the order they are moved to by users. You can drag and drop issues when sorted in Manual order to change their order. This sorting option is helpful when grooming the issues backlog and prioritizing issues.

The following table shows how issues can be sorted in both grid and board views.


| Grid view sorting options | Board view sorting options | 
| --- | --- | 
|  Manual order  |  Manual order  | 
|  Last updated  |  Last updated  | 
|  Priority  |  Priority  | 
|  Estimate  |  Estimate  | 
|  Title  |  Title  | 
|  ID  |    | 
|  Status  |    | 
|  Blocked  |    | 
|  Custom fields  |    | 

Use the following procedure to change how issues are sorted.

**To sort issues**

1. Navigate to your project.

1. In the navigation pane, choose **Issues**. The default view is the **Board**.

1. (Optional) Choose **Active issues** to open the **issues view switcher** dropdown menu to navigate to a different issues view.

1. To sort a grid view, there are two options:

   1. Choose the **header** of the field you want to sort by. Choosing the **header** will cycle between ascending and descending order.

   1. Choose the **Sort by** dropdown menu and choose a parameter to sort by. Issues will be sorted in ascending order.

1. To sort a board view, choose the **Sort by** dropdown menu and choose a parameter to sort by. Issues will be sorted in ascending order.

# Grouping issues
<a name="issues-grouping"></a>

Grouping is used to organize issues on the board by multiple parameters, such as assignee, labels, and priority. 

**To group issues**

1. Navigate to your project.

1. In the navigation pane, choose **Issues**. The default view is the **Board**.

1. (Optional) Choose **Active issues** to open the **issues view switcher** dropdown menu to navigate to a different issues view.

1. Choose **Group**.

1. In **Group by**, choose a parameter to group by: 
   + If you choose **Assignee** or **Priority**, choose the **Group order**.
   + If you choose **Label**, choose the labels and then choose **Group order**. 

1. (Optional) Choose the **Show empty groups** toggle to show or hide groups that have no issues currently assigned to them.

1. The view updates as you make your choices. An issue only appears in the group that matches the configured parameters. 

# Filtering issues
<a name="issues-filter"></a>

Use filtering to find issues that contain a specified name, priority, label, custom fields, or assignee.

**To filter issues**

1. Navigate to your project.

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

1. (Optional) Choose **Active issues** to open the **issues view switcher** dropdown menu to navigate to a different issues view.
**Note**  
To filter based on a string in the issue name or description, enter the string into the issues search bar.

1. Choose **Filter**, then choose **\$1 Add filter**.

1. Choose the parameters to filter for. You can choose multiple filters and parameters. You can configure filters to show issues that match every filter or any individual filter by selecting **and** or **or**. The view will update to show the issues that match the filter.