Skip to main content
System StatusContact Support

Documentation related to the following products will soon be moved to a new portal: ( Agility, Agility Connect and Agility Integrations Continuum and ALM Connect
Links from the site will automatically redirect to the new site.
If you have any questions, please contact Support. Agility Community

Converting a Story to a Defect

This feature is available in all editions.



In cases, where a defect was mistakenly defined a story, you to quickly convert it to a story or defect it without having to recreate it. This article walks you through the steps.

What Happens When You Convert a Story to a Defect?

  • Converting a defect copies all common data from the story to the defect and deletes the original story.

  • All shared fields, tasks, tests, links, discussion notes, attachments and other relationships are moved to the new defect. Any fields that are not shared between stories and defects are lost.


Follow these steps to convert a story to a defect.

  1. Go to Product Backlog.

  2. Select Convert To Defect from the Edit action menu.



If the new defect contains a field that does not exist in the original story, you will receive the following error message. See Why do I receive a "Type" error when converting from story to defect or defect to story? for instructions on how to fix it.