Next.js on Vercel

1. Install

   In your Next.js project:

   npm i pagerless

2. Add the instrumentation file

   Pages, route handlers, server actions and middleware, on Node and the edge. onRequestError needs Next.js 15 or newer (pagerless 0.2.0).

   // instrumentation.ts
   export { register, onRequestError } from "pagerless/next";

3. Add the key

   Set it for production only, so previews stay quiet.

   vercel env add PAGERLESS_KEY production

4. Allow rollback

   In the Pagerless app, connect Vercel with an access token. Rolling back then takes one approval.

Or run npx pagerless connect and it does steps 1 to 3.

What Pagerless reads from Vercel

VERCEL_ENV and VERCEL_GIT_COMMIT_SHA become the environment and release, so a spike right after a deploy is tied to that deploy. Vercel's deploy webhooks, signed with your secret, are accepted too.

Updated October 22, 2026.