> For the complete documentation index, see [llms.txt](https://docs.simplifyqa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplifyqa.ai/introduction-to-test-execution-in-simplifyqa/create-a-suite/execute-your-test-suite-and-view-suite-reports.md).

# Execute your Test Suite and View Suite Reports

This section covers how to configure and execute a test suite—a group of related test cases bundled together for streamlined execution.

To execute a test suite:

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

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2F1bQay4OISv0EkRfynUVh%2FSUITE%20CHECKBOX.png?alt=media&amp;token=b4451b8f-6d3f-407b-a12f-73fb60fb235c" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FnwqtwMR2RfTgw9qxxaHu%2FSuite%20chrome.png?alt=media&amp;token=91a3cd46-e272-4a98-97d6-9e3ea6a63982" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FflVZEW6AgTQstvNoEOdZ%2FSuite%20execution%20type.png?alt=media&amp;token=dcc21f79-fdaa-4366-8a8b-4334a9ef8cb3" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FycPUYJrf8l5cdpHwEdoU%2FSUITE%20EXECUTION%20.png?alt=media&amp;token=b29fdf3a-89db-4e1d-ad43-afaef89cdfd9" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FyPeeJQhLX5jZSiFn6MLg%2F10.jpg?alt=media&amp;token=11bd8b51-a373-498b-abc0-b6278b0a4f8a" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FpO0B4oYg96IMKlus4nYL%2F11.jpg?alt=media&amp;token=2cc3ef52-b7aa-4790-a9b3-af21bd41efe7" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FzUXdFkH6hDSlwx6WvNz4%2F16.jpg?alt=media&amp;token=a7755e3d-a6c6-4d95-9873-fd597b7d9824" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FbLnlPv2m2uVSHxfPoHs5%2F17.jpg?alt=media&amp;token=c1a2a01b-f1f8-4a01-8609-f727665faece" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FU4jPxDkQ8Puaewb5ovVi%2F18.jpg?alt=media&amp;token=3914a893-4bba-48cb-8650-7762d0fdb89e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FoJHCSDdXEMq6STSlh4Bg%2F19.jpg?alt=media&amp;token=7b056555-79d3-4eb4-857e-f57cabbe630e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2F83qjdKRxaDujsHiujeAg%2F20.jpg?alt=media&amp;token=8e5ff60e-98ac-4405-8f47-99ca85f7696b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FGGZww8RZgvsGzyo4tRAx%2F21.jpg?alt=media&amp;token=21346075-38bf-4f25-99b9-e7ad36b0bce2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FwfeiNQtKrvpGljWFYLx6%2F22.jpg?alt=media&amp;token=a170e49e-09bb-4d41-9f7e-08dfae326287" alt=""><figcaption></figcaption></figure>

* Select failed test cases and click Run.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FjIlRmt7KlqxaiBCPmjMK%2F23.jpg?alt=media&amp;token=08d3edfc-c8a5-495f-8591-8497b153271a" alt=""><figcaption></figcaption></figure>

* Modify test data if needed before re-execution.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FRqnq2QBKTea75jzz28xs%2F24.jpg?alt=media&amp;token=8d701007-9d5d-4757-96b1-026d881e5dc7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FBBogO51FhitLg3c0Zauj%2F25.jpg?alt=media&amp;token=5892c37f-4540-4289-a3d7-8a53d7f1209b" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FfXOc9Yy8j63wdy5THKuU%2Fsuite%20reports%20download.png?alt=media&amp;token=48af97ed-90de-4e0b-a16f-c9008979bdc1" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FhC32x0aauAuTlpeoJaOB%2F26.jpg?alt=media&amp;token=309ca737-d3fe-4271-92d9-f71fa4ae7535" 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="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2Fjf1X8Yn2jmGn0A7QGzkQ%2FManual%20suite%20and%20automation%20suite.png?alt=media&amp;token=491fa790-8ee8-4126-9321-4ca73b10db19" alt=""><figcaption></figcaption></figure>
