Configuring Separate Test Steps and Test Results - TestRail

Configuring separate test steps and test results

Are you using TestRail 5.2 or later? Congratulations, you don’t need to configure anything to use separate test case steps.

Separate test steps are already configured as part of our test case template feature now. You can simply select the template for your test cases:

If you would like to use separate test steps by default, you can also change the default template under Administration > Customizations:

Configuring separate test steps in earlier versions of TestRail (prior to 5.2)

TestRail versions prior to 5.2 support either entering test steps and expected results for test cases via simple text fields (the default configuration), or you can configure TestRail to manage test steps separately in a more structured way (including specifying separate test results for the test steps). The following screenshot shows the separate test steps configuration and this guide explains how to configure TestRail this way.

info Please Note: if you already have test cases and step details in your TestRail instance, then deleting your existing Steps field will delete all your existing steps. It’s recommended to keep the default Steps field active until you’ve migrated your test steps. Unlinking the default Steps field from your projects instead of deleting the field is recommended in all cases.

Follow these steps to configure separate test steps in TestRail:

  1. Select Administration > Customizations
  2. Under the Case Fields table, click the Add Field button
  3. For the Label enter Steps. For the System Name enter steps_separated. As the Type, select Steps.
  4. Before you save the new field, click the Add Projects & Options link in the Projects table below. In the dialog, just click OK to use the defaults and to assign the custom field to all projects
  5. Now click the Add Field button to submit the field

Test results

Now, in addition to the test steps for the cases, you can also configure TestRail to display the steps in the Add Test Result dialog. This will allow you to select results for separate steps like this:

To configure separate test step results, just add a custom field to the Add Test Result dialog:

  1. Under the Result Fields table, click the Add Field button
  2. For the Label enter Step Results, and for the System Name enter step_results. As the type, select Step Results.
  3. Add the field to all projects again
  4. Click the Add Field button to submit the field

Actual Results

You can optionally also allow testers to enter actual test results in the Add Test Result dialog. This can be useful to record additional details when testers enter the results. For example, if you want to record specific measurements for each step (such as the measured temperature of a device you are testing), then configuring the Actual Result field can be useful.

To do this, simply follow these steps:

  1. Edit the Step Results field under Administration > Customizations
  2. Edit the project assignment in the table at the end of the Edit Custom Field page (via the little pencil icon)
  3. Check the option to Use a separate Actual Result field for each step and click OK
  4. Click the Save Field button to submit the field

When you then enter a test result for a test case that has separate test steps entered, you can optionally enter an actual result for each step:

Additional notes

You might also want to delete or disable the preconfigured custom fields such as Preconditions, Steps, and Expected Results (please see the note above). To disable a field, edit it and simply remove the entry from the Projects table. This will remove the fields from all projects without deleting the entered data so you can restore the fields later if needed.

We usually recommend adding a Description text field to cases and disabling the Preconditions, Steps, and Expected Results fields when configuring separate steps, but this can be configured as needed. You can also keep the built-in steps text field temporarily in order to migrate your existing data to the new format, in case you have any.