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

# Link an issue to another issue
<a name="issues-link-issue"></a>

If an issue is related to work in another issue, you can link them. This is a quick way to help you understand and track dependencies between work items.

When linking an issue, there are four states to choose from:
+ Related to: Use this state to indicate work that is related to the linked issue.
+ Blocked by: Use this state to indicate that the issue is blocked by the linked issue.
+ Blocking to: Use this state to indicate that the issue is blocking progress on the linked issue.
+ Duplicate: Use this state to indicate that the issue duplicates work captured in another issue.

You can change the state of a link after you create it. Links and their link state appear in **Linked issues** in both the issue where you create the link, and the issue that is linked. You can also remove links after they are created.

**To link an issue to another issue or task**

1. Open the issue you want to link to another issue. For help with finding your issue, see [Finding and viewing issues](issues-view.md).

1. Choose **Link issues**.

1. In **Mark as**, choose the state for the link.

   In **Issue \$1**, enter the number for the issue, or choose it from the drop-down list.

1. To add another link, choose **Add linked issue**.

1. When you are done, choose **Update** to update the issue and all linked issues with the linked relationship.