> For the complete documentation index, see [llms.txt](https://docs.testery.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testery.io/get-to-know-testery/test-runs.md).

# 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.

![](/files/-MK1WFidam8WkQKuGOMR)

## 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="/files/RVWHOEkCAvKQISzCEK1N" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/KYsPGmABRNXk5kIL0uQR" 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.

<figure><img src="/files/gDIfZHP0PNfcywF8k4bu" 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.](/get-to-know-testery/test-runs/test-selection-rules.md)

<figure><img src="/files/I6i9FQML1R66NT8gwFEJ" alt=""><figcaption></figcaption></figure>