# Execute your Test Suite and View Suite Reports

To execute a test suite:

1. Select the test cases you want to execute by checking the corresponding checkboxes.

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

2. Choose the required Execution Platform:

* If executing Mobile Test Cases, select the appropriate Device (iOS/Android) and ensure the test environment is set up.
* If executing Web Test Cases, select the preferred Browser

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

3. **Select the Execution Type**\
   Choose how the test suite should be executed:
   * **Local** – Runs the suite on your local machine using your configured drivers and settings.
   * **Remote** – Executes the suite on a remote server or grid that you’ve integrated with SimplifyQA.
   * **Cloud** – Utilisnes third-party cloud platforms (like BrowserStack or Sauce Labs) for execution across different environments and devices.

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

4. Click Run to initiate execution. A pop up will open and select the desired release and sprint and click execute.

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

During execution, test progress and logs can be monitored in real-time.

### Suite Execution Settings

* Click on the Settings button to configure additional execution options.&#x20;

{% hint style="success" %}
**Note:**  Suite Settings option will only be available for automation test suites.
{% endhint %}

<figure><img src="/files/8Ak86X7mNDpKu5iDfZcZ" alt=""><figcaption></figcaption></figure>

* Auto Re-execution: Defines how many times a failed test case should be retried automatically. Helps reduce the impact of flaky or environment-sensitive test failures. You can configure the number of retry attempts based on your needs.
  * At the End of the Suite: Re-executes all failed test cases after the entire test suite has finished running. Ensures full test coverage before revisiting any failures.
  * At the End of Each Test Case: Immediately retries a failed test case after execution. Continues retrying until the test passes or reaches the retry limit, making it ideal for catching intermittent or transient issues.
* Auto Logging of Defects: Automatically logs defects for any failed test case when this feature is enabled in the Admin Module. Ensures consistent issue tracking and accelerates feedback to the development team.
* New Browser Session: Allows you to choose whether each test case runs in a fresh browser session or reuses a single session across test cases. Use new sessions for better test isolation; reuse sessions to speed up execution.
* Terminate on Failure: Stops the entire suite execution immediately if a test case fails. Useful for sanity or critical path testing where early failure detection is a priority.

<figure><img src="/files/feo15qu8QnYSYJlRUQD9" alt="" width="563"><figcaption></figcaption></figure>

Make any required changes and click 'Save' to apply the settings.

### Viewing Execution Reports

Once execution is complete:

1. Click on the Reports icon to view detailed execution results.

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

2. Reports include:

* Execution time: Total time taken for execution.
* Executor details: Information about the user who executed the suite.
* Technology used: The automation framework or technology used.
* Execution status (Pass/Fail): A summary of passed and failed test cases and more details.

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

3. Click the Arrow next to each test case to view individual test execution reports.

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

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

4. View Execution History to track previous suite executions and compare results.

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

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

5. Re-execute test cases directly from the Reports page:

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

* Select failed test cases and click Run.

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

* Modify test data if needed before re-execution.

<figure><img src="/files/5C2RmGsr4IsMvjZ0u8kW" alt=""><figcaption></figcaption></figure>

6. Click Excel Export to download execution details for reporting and analysis.

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

### Downloading Suite Reports

To download the execution report of a suite, at the **Reports** section. Click on the **PDF icon** to generate and download a PDF report containing the complete execution details of the suite.

<figure><img src="/files/6LUt8LwTRYAuxTYKIN91" alt=""><figcaption></figcaption></figure>

### Navigating Back to Suite from Reports

* Click Go to Suite from the Reports page to return to the suite overview, allowing for quick iteration and re-execution of test cases.

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

{% hint style="info" %}
**Manual Suite**:

* **Suite Execution Settings** are *not available* in manual suites.
* You can **only perform Local Execution**—integration with remote servers or cloud platforms is not supported for manual test execution.

**Automation Suite**:

* Full access to **Suite Execution Settings**, allowing configuration of retry logic, browser session handling, and more.
* Supports **Local, Remote, and Cloud Execution**, offering greater flexibility and scalability for automated test scenarios.
  {% endhint %}

<figure><img src="/files/FznqViX0CCiBrgdYZx2W" 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.simplifyqa.ai/introduction-to-test-execution-in-simplifyqa/create-a-suite/execute-your-test-suite-and-view-suite-reports.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.