Skip to main content
You need:
  • A repository using the Checkly CLI
  • At least one Playwright Check Suite defined in your repository.
Groups organize checks and share configuration across them. See the Groups overview for details on benefits and how groups work.

​
1. Create a group

Create a new file to define your group.
website-group.check.ts
import { CheckGroupV2 } from 'checkly/constructs'

export const myGroup = new CheckGroupV2('production-group', {
  name: 'Production group',
  activated: true,
  muted: false,
  locations: ['us-east-1', 'eu-west-1'],
  tags: ['production', 'playwright'],
  environmentVariables: [],
})
Learn more about using groups.

​
2. Add a Playwright Check Suite to the group

Import the group and reference it in your Playwright Check Suite configuration:
checkly.config.ts
import { defineConfig } from 'checkly'
import { myGroup } from './website-group.check'

export default defineConfig({
  logicalId: 'checkly-website',
  projectName: 'checkly-website',
  checks: {
    playwrightConfigPath: './playwright.config.ts',
    playwrightChecks: [
      {
        name: 'Critical Tests',
        logicalId: 'critical-tests',
        pwTags:'critical',
        frequency: 10,
        locations: ['us-east-1',],
        group: myGroup,
      },
    ],
  },
})

​
3. Deploy your changes

npx checkly deploy --preview # preview what will be deployed
npx checkly deploy           # deploy the new scheduled Playwright Check Suites into the group
Your Playwright Check Suite now appears in the group in your Checkly Home Dashboard.

​
Add multiple check suites to one group

Add multiple Playwright Check Suites to the same group while keeping individual test selection and frequency settings. Reference the group in each suite:
checkly.config.ts
import { defineConfig } from 'checkly'
import { myGroup } from './website-group.check'

export default defineConfig({
  logicalId: 'checkly-website',
  projectName: 'checkly-website',
  checks: {
    playwrightConfigPath: './playwright.config.ts',
    playwrightChecks: [
      {
        name: 'Critical User Flows',
        logicalId: 'critical-flows',
        pwTags: 'critical',
        frequency: 5,
        group: myGroup,
      },
      {
        name: 'Authentication Tests',
        logicalId: 'auth-tests',
        pwTags: 'auth',
        frequency: 10,
        group: myGroup,
      },
      {
        name: 'Checkout Flow',
        logicalId: 'checkout-flow',
        pwTags: 'checkout',
        frequency: 5,
        group: myGroup,
      },
    ],
  },
})