> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/test-execution/test-runs/create-and-manage-test-runs.md).

# Create and Manage Test Runs

## Create a Test Run

{% hint style="success" icon="unlock" %}
To create a test run, you need **Test Plan Management → Test Plan → Create/Edit** permission
{% endhint %}

#### Steps

{% stepper %}
{% step %}

#### **Go to Test Execution** <i class="fa-arrow-right">:arrow-right:</i> **Test Runs**

<div align="left"><figure><img src="/files/OhaaW4Dc92WcuRfQYtOp" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **Click** <i class="fa-plus">:plus:</i> **Add Test Run**

<div align="left"><figure><img src="/files/AETytHY6s38b5ez5BjGQ" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Enter Details&#x20;

* **Title** *(required)*
* **Test Project** *(required)*
* Select test cases:
  * By default, **Ready for Testing** tests are selected when you select the Test Project
  * You can manually include Draft tests
* (Optional) Select **Environment**

{% hint style="info" %}
If the project includes at least one automated test and multiple environments are configured, the **Environment** field will be shown.&#x20;

You can select an environment from the Data Repository. If no environment is selected, tests will run using the **Default** environment.
{% endhint %}

* Select Assignee from **Assign To** dropdown&#x20;

{% hint style="info" %}
You can assign tests one by one or select multiple tests later in the **Test Run Results Detail view**.
{% endhint %}
{% endstep %}

{% step %}

#### **Click Add**

* The test run appears in the list
* Selected test cases are added
  {% endstep %}
  {% endstepper %}

## Manage Test Runs

### **Re-create a Test Run**

{% hint style="success" icon="unlock" %}
To re-create a test run, you need **Test Plan Management → Test Plan → Create/Edit** permission
{% endhint %}

* Right-click <i class="fa-arrow-right">:arrow-right:</i> **Re-create**
* Creates a new test run using the original configuration
* Automatically includes:
  * Previously selected test cases
* Any new **Ready for Testing** test cases added to the test case library

{% hint style="info" %}
💡 Useful for rerunning tests with updated coverage
{% endhint %}

### **Run a Test Run Automatically**

{% hint style="success" icon="unlock" %}
To run a test run automatically, you need **Test Plan Management → Test Plan → Run Automated Test** permission
{% endhint %}

* Right-click on a test run <i class="fa-arrow-right">:arrow-right:</i> **Run Automatically**
* Automatically triggers execution for all **automated test cases** in the test run

**What Happens**

* Automated tests are:
  * Added to the [**Automated Test Queue**](/test-execution/automated-test-queue.md)
  * Executed remotely on the **cloud runner**

{% hint style="info" %}
If no automated tests are included, a toast message is shown: *“Test run contains no automated tests”*&#x20;
{% endhint %}

### **Copy Link to Share a Test Run**&#x20;

* Right-click <i class="fa-arrow-right">:arrow-right:</i> **Copy Link**&#x20;
* Share the link to provide direct access
* Opening the link navigates users to the test run

### Edit a Test Run

{% hint style="success" icon="unlock" %}
To edit a test run, you need **Test Plan Management → Test Plan → Create/Edit** permission
{% endhint %}

* Open a test run by:
  * Right-click <i class="fa-arrow-right">:arrow-right:</i> **Edit**
  * Or double-click the test run
* Update:
  * Test run **Title**
  * Included **test cases**

{% hint style="info" %}
The associated **project cannot be changed**
{% endhint %}

### **Close a Test Run**

{% hint style="success" icon="unlock" %}
To close a test run, you need **Test Plan Management → Test Plan → Create/Edit** permission
{% endhint %}

* Right-click → **Close**
* Confirm the action

{% hint style="warning" %}
&#x20;Once closed:

* No new results can be added
* The test run cannot be reopened
  {% endhint %}

### **Delete a Test Run**

{% hint style="success" icon="unlock" %}
To delete a test run, you need **Test Plan Management → Test Plan → Delete** permission
{% endhint %}

* Right-click → **Delete**
* Confirm the action

{% hint style="danger" %}
Deleting a test run is permanent and cannot be undone
{% endhint %}