---
title: Test Suites
description: Organize Synthetic Monitoring tests into logical groups.
breadcrumbs: Docs > Synthetic Testing and Monitoring > Test Suites
---

# Test Suites

## Overview{% #overview %}

Synthetic Monitoring Test Suites let you organize multiple tests into a single collection for simplified management and troubleshooting. Group tests by user journey, environment, location, service, team, or any other dimension that fits your workflow. View aggregated results, identify failing components, and understand application performance across related tests, all from a unified view. Configure suite-level alerting to receive a consolidated notification when a critical portion of your tests fail, helping you respond more efficiently to issues impacting important workflows.

## Key features{% #key-features %}

- **Impact-driven alerting**: Receive a consolidated alert when a critical portion of the test suite fails.
- **Centralized visibility**: View all tests in a suite and their results in one place.
- **Simplified management**: Create and run test groups instead of managing individual tests separately.
- **Easier maintenance**: Identify which tests need updates when application changes are made.

## Create a test suite{% #create-a-test-suite %}

To create a new Test Suite:

1. In Datadog, navigate to **Digital Experience**.
1. Click **New Test Suite**.
1. Optionally, navigate to the [Synthetic Monitoring tests](https://app.datadoghq.com/synthetics/tests) page, and click **+ New Suite**.

## Test suite configuration{% #test-suite-configuration %}

1. Enter a name for your suite (for example, `Checkout flow` or `API health checks`).

1. Click **Add Tests** to include existing Synthetic Monitoring tests.You can:

   - **Search** by name or tag.
   - **Filter** by test type (such as Browser, API, Private Location, or Mobile).
   - **Select** one or more tests to include.

1. Click **Add Tests** to confirm.

1. *Optionally, remove tests using the Remove Test from Suite icon next to each entry*.

1. Configure alerting for the suite:

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com



{% alert level="warning" %}
Alerting for Test Suites is not supported for this [Datadog site](https://docs.datadoghq.com/getting_started/site) ()
{% /alert %}


{% /callout %}

- By default, all tests are marked as **Critical**, and the alert triggers when any critical test fails.

**Note**: Suite alerts are separate from individual test alerts. To avoid duplicate notifications, mute alerts on individual tests included in the suite.

- To exclude specific tests from triggering the suite-level alert, select them and mark them as **Ignored**.

- Adjust the alert threshold to trigger only when a specified percentage of critical tests fail.

{% image
   source="https://datadog-docs.imgix.net/images/synthetics/test_suites/suite_alerting.73d1086e97eec0d2d9c0e280b503a8e9.png?auto=format"
   alt="Suite alerting creation page, with the suite alerting drop-down expanded. " /%}

**Note**: For existing test suites, alerting is enabled with default settings. You can modify the configuration as needed.
Configure [monitor settings](https://docs.datadoghq.com/synthetics/notifications/) (notification message, recipients, renotification) the same way you would for a single test.Click **Save Suite** when finished.
{% image
   source="https://datadog-docs.imgix.net/images/synthetics/test_suites/test_suite_creation_2.06743d04f80a6424a0f271fcc5cfa69c.png?auto=format"
   alt="Synthetic Monitoring Test Suite creation page" /%}

## View and manage{% #view-and-manage %}

After creating your suite, it appears in the **Suites** tab on the [Synthetic Monitoring tests](https://app.datadoghq.com/synthetics/tests) page, or you can access test suites from **Digital Experience > Test Suites**.

To apply a [Scheduled downtime](https://docs.datadoghq.com/synthetics/platform/downtime/) to one or more test suites, select them using the checkboxes and click **Add to Downtime** in the bulk actions bar.

When viewing a test suite, three tabs are available:

- **Tests in the Suite**: Lists all tests included in the suite.
- **Test Runs**: Displays global uptime metrics and related test runs.
- **Attributes**: Shows suite attributes such as `team`, monitors, and who created the test suite.

**Note**: Test runs appear in the suite only from the date the test was added. To view earlier results, check the individual test page. If you rename a test, previous runs remain listed under the original name. A maximum of 300 tests can be added per suite.

{% image
   source="https://datadog-docs.imgix.net/images/synthetics/test_suites/test_suite_summary_2.4c05224533da7d8171decaedae8fa548.png?auto=format"
   alt="Synthetic Monitoring Test Suite summary page" /%}

## Run a test suite{% #run-a-test-suite %}

To manually trigger the tests in a suite:

1. Navigate to the suite and click the **Tests in the Suite** tab.
1. Select the tests you want to run using the checkboxes.
1. Click **Run Tests Now**.

{% image
   source="https://datadog-docs.imgix.net/images/synthetics/test_suites/run_tests_now.29c3bbda18ac037ee85614db97e09775.png?auto=format"
   alt="The Tests in the Suite tab with tests bulk selected and the Run Tests Now button visible" /%}

**Note**: You can run a maximum of 50 tests at a time.

## Troubleshooting{% #troubleshooting %}

If some tests fail to appear in a suite:

- Ensure the tests are active and not deleted.
- Confirm you have the necessary permissions to view those tests.
- Refresh filters or clear search terms when adding tests.

If execution results look incomplete:

- Verify test run frequency and recent activity.
- Check for tag or location mismatches that could filter out runs.
- Re-save the Test Suite to refresh the association with its tests.

## Further Reading{% #further-reading %}

- [Learn about Synthetic Monitoring](https://docs.datadoghq.com/synthetics/)
- [Configure Synthetic test monitors](https://docs.datadoghq.com/monitors/types/synthetic_monitoring/)
- [Synthetic Monitoring Troubleshooting](https://docs.datadoghq.com/synthetics/troubleshooting/)
- [Get organized, actionable insights from complex test environments](https://www.datadoghq.com/blog/test-suites/)
- [Understanding Synthetic Monitor Alerting](https://docs.datadoghq.com/synthetics/guide/how-synthetics-monitors-trigger-alerts/)