# Test Lists in Test Studio

The test lists in Test Studio are a set of tests to be executed in a sequence. You can combine autonomous tests in dynamically generated list and each will be executed in a new browser instance. Or you can pack tests to run in predefined sequence - self-reliant or dependent on the previous tests in the list.

Test Studio provides two options for a test list - a static one, which contains a fixed, predetermined list of tests; and dynamic, which contains a list of tests that is dynamically generated upon execution, based on the properties set for the tests in project. This article describes in details the two kind of test lists:

* <a href="#how-to-create-a-static-test-list">Static Test List</a>

- <a href="#how-to-create-a-dynamic-test-list">Dynamic Test List</a>

> **Tip**
> <br>
> <br>
> Both *Static* and *Dynamic* test lists can execute **web, responsive web, WPF and load tests**.
> <br>
> **Performance** and **Manual** tests can be executed in a *Static* test list only by changing the type of the test list.

<br>
<br>

## How to Create a Static Test List?

Choose the **Test Lists** tab in the Test Studio project and hit the **List** button in the *Add* section of the tools ribbon.

![Create List Button](https://www.telerik.com/teststudio/documentation/assets/a53a1592ffa5b33292b551cd28c504e4/fig1.png)

### Choose Name and Type of the Test List

The **'Create a New Test List'** dialog pops up and lets you choose the *Name* of the list, the *Type* and *Tests* to include. Changing the *Type* of the test list determines what tests can be included in it - <a href="/automated-tests/test-lists/test-lists-standalone#automated-type-of-test-list" target="blank">**Automated**</a> for web, responsive web, WPF and load tests, <a href="/automated-tests/test-lists/test-lists-standalone#performance-type-of-test-list" target="blank">**Performance**</a> for running web tests in performance mode, and <a href="/automated-tests/test-lists/test-lists-standalone#manual-type-of-test-list" target="blank">**Manual**</a> for executing manual tests.

![Choose Test List Type](https://www.telerik.com/teststudio/documentation/assets/de9fa829a43606a5b7b8a4b5358a290a/fig2a.png)

### Add Tests to the Test List

To add a test in the test list, select it on the left side of the dialog, and move it to the right pane by *using the arrow buttons*, or by *double clicking* on the test name. Once all tests are added, you can click the **OK** button to save the new test list.

![Name the test list and Add tests](https://www.telerik.com/teststudio/documentation/assets/6a6ebfa7c1316059e338b524fa341ec9/fig2.png)

> **Tip**
> <br>
> <br>
> Select multiple tests using the *Shift* key or *Ctrl*+ Mouse click.

<br>
<br>

### Options to Filter the Listed Tests from Project

* **Filter Tests by Type**

  ![Filter](https://www.telerik.com/teststudio/documentation/assets/3415c11b083edeb5cc54b616c6e6454c/fig2_filtertestsbytype.png)

* **Filter Tests by Name**

  ![Search](https://www.telerik.com/teststudio/documentation/assets/ea3c658d707de26951262296ded7ea7d/fig2_searchfield.png)

* **Use the *Collapse* Button** to collapse any expanded folders in the listed tests from project. By default when the *'Create a New Test List'* dialog appears, all folders are expanded to see the tests these include.

  ![Collapse](https://www.telerik.com/teststudio/documentation/assets/4fb52a38d8ad01e0ff8ffc16a313fc44/fig2_collapse.png)

<br>
<br>

## How to Create a Dynamic Test List?

There are few test properties you can use to create rules for tests to include in a dynamic test list.

### Test Properties to Filter Tests in Dynamic List

There are **few criteria you can define to filter tests** upon execution, when creating a dynamic test lists - **test name**, **test path** and the rest are the **user defined <a href="/features/test-maintenance/test-properties-standalone" target="blank">test properties**</a> (*Owner, Priority, Custom Property 1, 2, 3*). For the purpose of this example, two of the user-defined properties were modified - *Owner* was set to Telerik and *Priority* to 1.

![Test properties](https://www.telerik.com/teststudio/documentation/assets/f505089ae0cad2d1d03340c7931d603d/fig6.png)

> **Note**
> <br>
> <br>
> The test's ***Priority* property does not affect the order** of tests to be executed in a test list. It is a property to be used for filtering rules in the dynamic test lists.

### Create Dynamic Test List

To be able to use these properties, you need to choose the **Dynamic List** button in the *Add* section under the **Test Lists** Tab

![Add Dynamic test list](https://www.telerik.com/teststudio/documentation/assets/8851d1e40e3314fff2cae8b75ff2ad3e/fig7.png)

### Define Rules to Filter the Tests

The **'Add Dynamic Test List'** dialog pops up and lets you choose the *name* of the list and *create rules* which tests to include upon execution. **Craft one or more *Rules*** to filter on specific criteria, clicking plus button after each one. The current results are displayed real-time. Once done, click the **OK** button to save the new test list.

![Define Rules which tests to be included in the dynamic list](https://www.telerik.com/teststudio/documentation/assets/b38463e6d8feced79630f833944ed920/fig8.png)

> **Note**
> <br>
> <br>
> Each time you click the *Run List* button, Test Studio dynamically queries the project and executes the tests that meet the criteria of the **Rules**. So, if there are new tests added, which meet the criteria of the rules, these will be included in the test list upon execution.

<br>
<br>

## How to Execute a Test List?

Once you have created a test list, you can <a href="/automated-tests/test-lists/test-list-execution" target="_blank">execute it</a> immediately using the **Run List** button from the *Execution* section of the ribbon. If you need to schedule the test list run for a future time, or execute it on another machine, you will need to configure the Test Studio Scheduling configuration and then use the **Run List Remotely** or **Schedule Test List** buttons.
