← Back to Guides

How can I run end-to-end tests after my Vercel Preview Deployment?

Learn how to use the Vercel CLI in combination with your CI/CD provider to run end-to-end tests for every code change.
Last updated on April 7, 2025
Build, Deployment & Git

You can run an end-to-end test suite after your Vercel deployment has finished with the following methods:

  1. Connect your Git repository to your project. For new projects, you can follow these docs. For existing projects, visit your Git configuration in the Settings tab of your project dashboard.
  2. Create a GitHub workflow in .github/workflows with the following:
name: Playwright Tests


on:
  repository_dispatch:
    types:
      - 'vercel.deployment.success'
jobs:
  run-e2es:
    if: github.event_name == 'repository_dispatch'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.client_payload.git.sha }}
      - name: Install dependencies
        run: npm ci && npx playwright install --with-deps
      - name: Run tests
        run: npx playwright test
        env:
          BASE_URL: ${{ github.event.client_payload.url }}
A GitHub Action that runs an end-to-end test suite using repository_dispatch events.
  1. Configure a webhook for the deployment.succeeded event.
  2. Listen for the webhook to trigger your CI workflow.
  3. Run end-to-end test suites.

Couldn't find the guide you need?