Test Management for Jira Cloud

Run a Test Cycle

We’re excited to announce that TM4J, Test Management for Jira, is now part of the SmartBear family. Learn more.

This topic walks you through the test-execution process, including working with test steps, managing Jira defects, attaching images, and more.

Execute a Test Cycle

On the Cycles view, select a test cycle, then click Run. Or you can click the Key or Name links. All roads lead to the Test Player.

These options allow you to begin testing or continue testing.

In the Test Player, you can update the status and start the test-execution timer.

You can also enter testing time manually by clicking the ellipses button, entering the hours and minutes (hh:mm), and clicking Save.
Time summaries appear at both the test-cycle level as well as at the test-case level.

Complete testing for each test case, and set the result for each test step by clicking the Pass, Fail, or Blocked icons.


If necessary, you can update the results of any remaining steps in bulk. Simply click the cog icon, then select your desired result from the Set All Below To section.


You can create a new or link an existing defect to a test case or to a test step.

At the test-case level, use one of the following two options in the Issues section.


At the test-step-level, you can create a new or link an existing defect to any test step by clicking the cog icon, then selecting Create Issue or Search Issues.


If you click Create Issue, fill out your desired fields on the Create Issue screen, then click Create to link the new issue to the test step.


You can see the linked defect in both the test-case list and the step.


Links also appear on the defect in the Impacted Test Executions section.

run 11

Images in Test Steps

You can attach files to a step in three ways:

  • Click Insert Image in the Actual Result section. This attaches the actual image to the step rather than the file (which requires a click to open and view).

  • Click the cog icon to attach files to the step.

  • Drag-and-drop an image file onto the test step.

You can remove an image file by hovering over it and clicking Delete.


Track Progress

From the Cycles view, you can track execution stats, such as progress, effort, issues raised, etc. See the Column Options section of Work with Test Cycles for more information on customising your view.


If a defect has been created and attached to a step in a test cycle, you can hover over the issue link to view a link to the defect. (Note that to view defect links, you must have Issues selected as one of your columns options.)

Just hover over the issue link:

run 15

And a link to the defect appears in a tooltip.

run 16

Rerun Tests and View History

When the time comes to reuse a test cycle and rerun the test cases, click Start a New Test Execution. This archives the previous test data and allows you to start testing from scratch.


Scroll to the bottom of the Test Player screen to view archived test cycles. The most recent tests appear at the top of the list.

Click > to expand and view the archived test data.