Skip to main content
System StatusContact Support Agility Community

Adding/Creating a Defect

This feature is available in all editions.



Defects are generally entered and planned in the Product Planning area. Here, they can be parsed out to specific projects in the hierarchy, and then reviewed by the team and scheduled into a sprint/iteration.

Option 1. Inline in Any Grid

Choose this option to quickly add empty rows to any grid.

  1. Click Add Defect Inline to the right of the grid.

  2. When the new row displays, type the details in the available fields, and then click Save.

Option 2. Using the Defect Details Page

The defect details page provides additional fields and allows you to enter more detailed information about the story.

  1. In any grid, click select Add Defect from the Add Story Inline drop-down menu.

  2. When the Defect Details window opens, type in the appropriate fields, and then click Save.

Option 3. In the Sidebar

  1. Click on the plus icon in the sidebar.
  2. Select the type of asset you want to add.

  3. Enter the asset details, and then click Save.

The Asset Tray was replaced by a static Sidebar in the Summer 2017 (17.2) release. Prior releases still display the Asset Tray.

Option 4. Import Defects from a Spreadsheet

If your defects are in an Excel spreadsheet, or if you have a large number of backlog items to add, you can import them into the backlog using the Import feature. For instructions on how to do this, refer to Importing Stories, Defects, and Other Data from Excel.

Option 5. Generate a New Defect from a Template

If you have created defect templates, which are reusable assets that contain pre-defined defect details, you can use them as a starting point to create a new defect. To learn more, see Creating/Generating a New Defect from a Template.