# 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.&#x20;

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testery.io/get-to-know-testery/test-runs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.