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

# Netlify

Connect Netlify deploy notifications so TesterArmy tests every successful Deploy Preview on your pull requests. Connect [GitHub](/integrations/github) and enable PR testing first so TesterArmy can resolve the pull request and report results.

## Setup

1. In TesterArmy, open your project → **Integrations** → **Netlify** and click **Add Webhook**. Copy the generated URL - it contains the secret and won't be shown again.
2. In Netlify, go to [**Project configuration → Notifications**](https://docs.netlify.com/deploy/deploy-notifications/) and add an **HTTP POST request** notification.
3. Select the **Deploy succeeded** event, paste the webhook URL, and save.

On every pull request, Netlify builds a Deploy Preview and TesterArmy runs tests against the preview URL. Failed or still-building deploys never trigger tests - even if the webhook is also subscribed to those events.

## Troubleshooting

### Tests don't start

1. **No Deploy Preview** - PR testing needs Netlify Deploy Previews enabled (**Project configuration → Build & deploy → Deploy Previews**). Production deploys aren't tied to a pull request, so they are skipped.
2. **Wrong event subscribed** - the notification must fire on **Deploy succeeded**. Other events are accepted but ignored, so tests never start if only those are configured.
3. **Preview build skipped** - if the project uses an `ignore` rule (common in monorepos), Netlify skips unrelated PRs entirely: no notification fires and no tests run. That is the intended behavior.

### No PR comment appears

1. **GitHub App not connected** - verify the installation in Project Settings.
2. **Not a Deploy Preview** - only Deploy Previews are linked to a pull request; production and branch deploys don't get PR comments.
3. **Permissions** - the GitHub App needs **Pull requests: Read & Write**.