Manage Regression Tests

Regression tests are templates for acceptance tests that ensure previously delivered features continue to work as new features are added. These tests build a comprehensive test inventory for each release.

Who Manages Regression Tests

• Team Members: Create regression tests from completed acceptance tests and maintain test details.
• Scrum Masters: Organize regression test inventory across projects and manage test lifecycle (create, edit, close, delete).
• QA Specialists: Build comprehensive regression test libraries, update test procedures, and ensure test coverage.
• Product Owners: Review regression test inventory to verify critical features are protected and approve test promotion from acceptance tests.

Permission Requirement

To view regression tests, you must have Read access to the Product Planning area. To create, edit, move, or close regression tests, you must have Edit access to the Product Planning area. To delete regression tests, you must have Admin-level permissions or Edit access with deletion rights.

Access Regression Tests

To view the list of regression tests in a project, click the hamburger menu , and select Product > Regression Tests.

Create Regression Test

At the end of each sprint, new regression tests are typically generated from the list of acceptance tests attached to a story or defect. The team decides which tests should be promoted to a regression test. You can also create unattached regression tests using the Add button, the Add New... function in the left navigation area, or using Microsoft Excel import.

To create a regression test:

1. Click the hamburger icon > Product > Regression Tests.
2. Click Add Regression Test.
3. Enter the required information and click Save.

note

Regression tests can also be generated directly from acceptance tests for previous backlog items.

Edit Regression Test

You can edit regression test details using three different methods depending on your needs.

Option 1: Inline Edits in the Grid

Recommended for quick edits to basic details such as title, points, projects, etc.

1. Click the hamburger icon > Product > Regression Tests.
2. Double-click on a row to make the columns editable.
3. Change the details as appropriate, and then click Save.

Option 2: Edit in Grid

1. Click the hamburger icon > Product > Regression Tests.
2. Click Edit next to the item you want to change.
3. On the details page, modify the item as appropriate, and then click Save.

Option 3: Edit in Details Page

On the Regression Test Details page, click the Pencil icon next to the field you want to change. Make the appropriate changes (your changes are highlighted in yellow), and then press Enter or Return on your keyboard.

Move Regression Test to Project

You can move regression tests from one project to another to reorganize your test inventory.

To move a regression test:

1. Click the hamburger icon > Product > Regression Tests.
2. Select the regression test(s) you want to move and click the Move to Project button.
3. In the pop-up window, select a new project, and click Move.
   

Close Regression Test

Closing a regression test after it has been completed and approved removes it from the default tracking pages and indicates that the work is complete.

Option 1: In the Regression Test Grid

1. Click the hamburger icon > Product > Regression Test.
2. In the pop-up window, select a Status, and then click the Close Regression Test button.

Option 2: On the Details Page

1. Anywhere in the system, click on the regression test name or ID.
2. Select Close Regression Test from the Edit drop-down button.
3. In the pop-up window, select a Status and click Close Regression Test.

Delete Regression Test

You can delete regression tests that are no longer needed. Deleted tests are permanently removed from the system.

To delete a single regression test:

1. Click the hamburger icon > Product > Regression Tests.
2. Select the regression test you want to delete, and then select Delete from the Edit drop-down list.
3. In the pop-up window, click Delete. The test will be permanently removed from the system.

To delete multiple regression tests:

1. Select the checkboxes to the left of tests to be deleted.
2. Choose Delete from the Move to Project drop-down list.
3. Click Delete on the Delete Items page.

Troubleshooting

Why can't I create a regression test from an acceptance test?

The acceptance test must be associated with a completed backlog item or defect. Verify that the parent story or defect is marked as complete. If the acceptance test is unattached or the parent item is not closed, you cannot promote it to a regression test. Ensure you have Edit access to both the acceptance test and the target project.

Why can't I edit a regression test using inline editing in the grid?

Double-click on the row to enable inline editing mode. If inline editing doesn't activate, verify that you have Edit access to the Product Planning area. Some fields may not be editable inline; use the Edit button or Details page for those fields.

Why did my regression test not move to the target project?

Verify that you have Edit access to both the source and target projects. If the target project is in a different project hierarchy, ensure the regression test doesn't have dependencies (test suite associations) that prevent the move. Check that the target project supports regression tests.

Why can't I delete a regression test even with Admin permissions?

Regression tests that are associated with active test suites or have generated acceptance tests may be protected from deletion. Close the regression test instead of deleting it to preserve test execution history. If deletion is necessary, remove the test from all test suites first, then attempt deletion again.

Related Topics

• Regression Tests
• Regression Planning
• Acceptance Tests