> For the complete documentation index, see [llms.txt](https://docs.walnutai.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.walnutai.ai/test-and-quality-management/test-management/defects/link-existing-defects-to-user-stories.md).

# Link Existing Defects to User Stories

Defects can also be associated directly with user stories or requirements, allowing teams to understand which business requirements are impacted by a particular issue.

**To link a defect to a user story:**

* Open the required **User Story**.

<figure><img src="/files/Wt3J8xXOgUEMzHh5m5Y9" alt=""><figcaption></figcaption></figure>

* From the right-side panel, click **Link Defect**.

<figure><img src="/files/TFASfSMkKf8stEORQUvC" alt=""><figcaption></figcaption></figure>

* Select the appropriate defect from the list.
* Click **Done**.

<figure><img src="/files/KhiSnH62LZijYXXEJCwt" alt=""><figcaption></figcaption></figure>

* The selected defect is now associated with the user story.

<figure><img src="/files/sFt6ESXe5h65Fcoj7O2G" alt=""><figcaption></figcaption></figure>

By linking defects to requirements, product owners, business analysts, QA engineers, and developers can quickly identify all issues affecting a user story, improving requirement traceability and ensuring every impacted requirement is addressed before release.