# Test Runs

The Test Runs view shows a list of your most recent test runs. You can filter by Date, Project, Environment, or Status to find the test run you're looking for.

![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-52de91f399d9eddf786c6105a898703cf70facfb%2Fimage.png?alt=media)

## Test Run Status and Test Status

There are two kinds of statuses in Testery:

1. **Test Run Status** - the status of the entire test run regardless of how many tests are in it
2. **Test Status** - the status of a single test within a test run

#### Test Run Statuses <a href="#test-run-statuses" id="test-run-statuses"></a>

| **Status** | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SUBMITTED  | Test run has been submitted to the queue to be run                                                                                                                                                                                                                                                                                                                                                                                            |
| QUEUED     | Waiting for another test run in the same environment to finish. We do not run 2 test runs in the same environment at once.                                                                                                                                                                                                                                                                                                                    |
| RUNNING    | Test run is currently running                                                                                                                                                                                                                                                                                                                                                                                                                 |
| PASS       | All tests that are not ignored passed.                                                                                                                                                                                                                                                                                                                                                                                                        |
| FAIL       | There was at least one test in the test run that failed OR an error occurred and the test run can’t finish. If the latter happens a failure reason should display.                                                                                                                                                                                                                                                                            |
| CANCELED   | <ol><li>Test run was manually canceled by someone. (user’s username will display to show who canceled the test run) OR</li><li>Test run will be automatically canceled if it runs for more than 3 hours (message will be Canceled - Due to running too long) OR</li><li>Test run is in queued status and a newer test run comes in, the current queued test run will be canceled (message will be Canceled - Due to newer test run)</li></ol> |

#### Test Statuses <a href="#test-statuses" id="test-statuses"></a>

| **Status**                                                                                                                                                                                                                                                                        | **Description**                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| ![](blob:https://testery.atlassian.net/65ddf0f8-8cd9-4259-8bd5-e7c29f387cb2#media-blob-url=true\&id=6156bb52-66b1-4a29-bb05-19a132cb3bf8\&collection=contentId-621674497\&contextId=621674497\&mimeType=image%2Fpng\&name=testPass.png\&size=5267\&width=56\&height=18)PASS       | The test passed.                                       |
| ![](blob:https://testery.atlassian.net/10dbe6bf-2b76-4a74-a93a-d39b7f87f8e2#media-blob-url=true\&id=13cdf347-6650-49f9-bb91-a22d34c1c2e2\&collection=contentId-621674497\&contextId=621674497\&mimeType=image%2Fpng\&name=testFail.png\&size=4998\&width=56\&height=18)FAIL       | The test failed.                                       |
| IGNORED![](blob:https://testery.atlassian.net/4f5513dd-bd4f-43d1-9605-c9defe1b3358#media-blob-url=true\&id=a8026003-57c9-4143-840f-9bea74029a9e\&collection=contentId-621674497\&contextId=621674497\&mimeType=image%2Fpng\&name=testIgnored.png\&size=5409\&width=55\&height=19) | Test was flagged as ignored and this test did NOT run. |
| PENDING![](blob:https://testery.atlassian.net/49be41e6-1adf-4f95-89a1-61595a08b8ec#media-blob-url=true\&id=4c415ac0-f752-425c-9c33-2a9927e041cb\&collection=contentId-621674497\&contextId=621674497\&mimeType=image%2Fpng\&name=testPending.png\&size=5213\&width=56\&height=19) | Test is waiting to run.                                |
| ![](blob:https://testery.atlassian.net/dd84fe69-ccdb-4793-aee2-301a5d25656c#media-blob-url=true\&id=76fc104f-5367-4e37-96cc-009890eb7948\&collection=contentId-621674497\&contextId=621674497\&mimeType=image%2Fpng\&name=testRunning.png\&size=4840\&width=55\&height=20)        | Test is running.                                       |

#### Test Run Options

There are 4 options for define the tests that will be executed during your test run.

**Run all tests in project -** All tests detected in the project will be executed.

<figure><img src="https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-a2b25d42943bba2e7a08c77789d3d25ee13ae938%2FScreenshot%202024-12-09%20163639.png?alt=media" alt=""><figcaption></figcaption></figure>

**Select test suite -** Tests will be determined by a predetermined test suite.

<figure><img src="https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-7cc58c0ba7923f5cfa81e70ef39724e45c264970%2FScreenshot%202024-12-09%20163653.png?alt=media" alt=""><figcaption></figcaption></figure>

**Filter tests in project -** A one-time set of filters will be applied.  These can be done with include/exclude tags or by test file filters.&#x20;

<figure><img src="https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-08038c3b518799649b23f132025eacb8fdeb8d02%2FScreenshot%202024-12-09%20163719.png?alt=media" alt=""><figcaption></figcaption></figure>

**Use testery.yml -** Test selection will be controlled by the rules in the testery.yml file.  [Read here for details on how to define these rules.](https://docs.testery.io/get-to-know-testery/test-runs/test-selection-rules)

<figure><img src="https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-d529d36983356a8ea53aa9e58583193b22055ba6%2FScreenshot%202024-12-09%20163728.png?alt=media" alt=""><figcaption></figcaption></figure>
