> ## Documentation Index
> Fetch the complete documentation index at: https://www.checklyhq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Playwright Check Suites

> Run your Playwright end-to-end test suite as synthetic production monitoring.

![Playwright check overview](https://mintcdn.com/checkly-422f444a/x9HkiPSTkrv6lzMg/images/next/playwright-check-overview-light.png?fit=max\&auto=format\&n=x9HkiPSTkrv6lzMg\&q=85\&s=c894ed9510f7f2154015fdb2dc733d0e)

## What are Playwright Check Suites?

**Playwright Check Suites turn your Playwright end-to-end tests into production monitors.** Run entire test suites, specific projects, or tagged tests globally without modifying your existing code or configuration.

> [!WARNING]
>
> **Known limitations**: Each check run has a maximum execution time of 30 minutes.

![Playwright Check Suites test result](https://mintcdn.com/checkly-422f444a/Nt50VYKlZTEUPG3C/images/pwn-test-result.png?fit=max\&auto=format\&n=Nt50VYKlZTEUPG3C\&q=85\&s=ae7c2dedc3c25d79baa97da6a65a14f9)

**Use Playwright Check Suites to:**

* Turn E2E tests into global synthetic monitors
* Monitor complex user workflows across browsers and regions
* Detect issues in critical business processes
* Verify functionality after deployments

## How Playwright Check Suites Work

**1. 1. Select tests**

Choose which tests to turn into monitors using Playwright projects or tags from your existing configuration.

**2. Choose frequency and locations**

Specify the locations to run the check from, and set its frequency

**3. Deploy globally**

Run selected tests on schedules from global locations with performance tracking and detailed reporting.

**4. Get alerted**

Receive notifications when tests fail or performance degrades.

## Test Selection

Control which tests run as monitors using:

* **Projects**: Select browser and project configurations from your Playwright config with `pwProjects`
* **Tags**: Choose tests marked with specific tags (e.g., `@critical`, `@smoke`) with `pwTags`
* **Combinations**: Mix tags and projects for precise control
* **testCommand**: Use `npx playwright test ...` to select the tests you want to create a monitor for, using playwright flags like `--grep-invert` or `--projects`

Configure test selection in your `checkly.config.ts` file:

```typescript checkly.config.ts theme={null}
export default defineConfig({
  checks: {
    playwrightChecks: [
      {
        name: "Marketing Environment",
        logicalId: "environment-marketing-suite",
        // Select the tests defined in
        // the `environment-marketing` Playwright project
        pwProjects: ["environment-marketing"],
      },
      {
        name: "@critical tests",
        logicalId: "critical-tests",
        // Select tests tagged as `@critical`
        pwTags: ["@critical"],
      },
            {
        name: "customTestCommand",
        logicalId: "custom-testCommand-critical-no-smoke",
        // Select tests not tagged as `@smoke` and tagged as @critical
        testCommand: "npx playwright test --grep-invert @smoke --grep @critical"
      },
    ],
  },
})
```

> [!TIP]
>
> Learn more about [test organization strategies](https://www.checklyhq.com/docs/detect/synthetic-monitoring/playwright-checks/test-organization.md) for selecting and grouping tests.

## Monitoring Configuration

Customize how your checks run:

* **Frequency**: Schedule runs at regular intervals
* **Locations**: Deploy to multiple global regions
* **Alerting**: Set up notifications and escalation
* **Dependencies**: Use private packages and custom registries (see [custom dependencies](https://www.checklyhq.com/docs/detect/synthetic-monitoring/playwright-checks/custom-dependencies.md))

## Getting Started

> **[Quickstart Guide](https://www.checklyhq.com/docs/detect/synthetic-monitoring/playwright-checks/quickstart.md)**
>
> Deploy your first Playwright Check Suite

> **[Construct Reference](https://www.checklyhq.com/docs/constructs/playwright-check.md)**
>
> Construct configuration options and examples

> **[Add to Group](https://www.checklyhq.com/docs/detect/synthetic-monitoring/playwright-checks/add-to-group.md)**
>
> Organize checks with groups

> **[Custom Dependencies](https://www.checklyhq.com/docs/detect/synthetic-monitoring/playwright-checks/custom-dependencies.md)**
>
> Use private packages and custom registries


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.