Using Test Run Filters

When creating or editing test runs there are multiple options for choosing the test cases which you would like to include in your test run. This article explains the different selection options and their functionalities.

Include All Test Cases

The default selection when creating any test run is to include all test cases. With this option selected, all test cases from your project (or suite if your project has multiple suites enabled) will be included in the test run. Additionally, if you create new test cases within your project or suite, then these cases will automatically be added to your test run.

Select Specific Test Cases

This option allows you to choose specific test cases or apply a filter to choose test cases based on the specified criteria.

With a filter defined, you have the option to change your selection to match the new filter (this is the default 'Set Selection' option), add your filter to the test run's current selection of test cases, or remove the cases matching your filter from your test run.

Dynamic Filtering

Requires TestRail 6.2 or later.

This is a BETA FEATURE. Currently, when setting a filter based on test case sections, moving test cases into the selected sections will not add them to the test run. Also, moving a test case out of a selected section expands the scope of the dynamic filter. As soon as any issues related to this behavior are addressed, a release will be made available for all TestRail customers.

Dynamic filtering allows you to specify a filter for your test cases based on certain criteria. The filter dialog is similar to the dialog for selecting specific test cases.

For each test run with a dynamic filter, you will be able to apply a single filter to your test run. You can also select additional test cases and sections using the left-hand area of the dialog. This manual selection will not create a filter, however. Cases will only be automatically added and removed from your test run based on the filter criteria set.

With a dynamic filter set, any new test cases added to your project which also match this filter will be automatically added to your test run. When viewing your test run, any newly-added tests are identified by the filter icon . Additionally, if a test case is updated to no longer match the filter applied, the corresponding test will be removed from your test run.