> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://tester.army/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tester.army/_mcp/server.

# Vercel

GitHub remains the event source for Vercel PR testing, but you now need to install the TesterArmy Vercel integration and choose which single Vercel project this TesterArmy project should care about.

## Setup

1. [Connect GitHub](/integrations/github) and select the repository for this TesterArmy project.
2. Open **Integrations → Vercel**.
3. Click **Connect Vercel**. This opens the TesterArmy Vercel integration page on Vercel.
4. Install the integration for the personal account or Vercel team that owns the target project.
5. Back in TesterArmy, refresh the Vercel project list and select the Vercel project that matches this repository.
6. Optional: in **Integrations → GitHub**, choose the PR target branch to allow if you only want automatic runs for one base branch.

TesterArmy detects Vercel preview deployments via GitHub `deployment_status` events, then verifies that the deployment belongs to the selected Vercel project before any tests are queued.

## Why selection is required

One GitHub repository can be connected to multiple Vercel projects.

TesterArmy needs one explicit choice so it can safely ignore deployments from the wrong Vercel project instead of running tests against the wrong preview.

Only deployments from the selected Vercel project will trigger tests.

If a GitHub target branch is configured, the deployment must also belong to a PR targeting that base branch.

## Deployment protection bypass

If Vercel deployment protection blocks the preview URL, configure a Protection Bypass for Automation token after selecting the Vercel project. See [Vercel Preview Deployments](/auth/vercel-preview-deployments) for setup and troubleshooting.

## Status states

* **Connected, no project selected** - connect succeeded, but you still need to choose the Vercel project.
* **Active** - the selected Vercel project is accessible and used for verification.
* **Requires reconnect** - Vercel auth expired or was revoked.
* **Missing access** - the selected Vercel project is no longer accessible to the connected Vercel account.

## Troubleshooting

### No PR comment appears

1. **GitHub App not connected** - verify installation in Project Settings.
2. **Permissions** - the GitHub App needs **Pull requests: Read & Write**.
3. **Vercel not selected** - connect Vercel and choose the single Vercel project this project should test.
4. **Wrong Vercel project** - if the repo is linked to multiple Vercel projects, only the selected one is allowed to trigger tests.

### TesterArmy bot doesn't comment even after connecting everything

If you've connected GitHub and Vercel but still don't see the TesterArmy bot on your pull requests, check that Vercel is sending **`deployment_status` events** to GitHub. TesterArmy relies on these events to detect preview deployments, so if they're turned off, no tests are queued and no comment appears.

In Vercel, open your project's **Settings → Git → Connected Git Repository** and make sure **`deployment_status` Events** is enabled.

![Enable deployment\_status Events in Vercel](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/91ae07f062058907fd8de526996caade790ce2f12a57558b1c6ca3ec9ba30cd4/docs/assets/docs/vercel-deployment-status-events.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151244Z&X-Amz-Expires=604800&X-Amz-Signature=6d23923cab998abf995f89bd84c580fe571e79bd91a648d3aa87afbb991eb9d0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)