Next.js 16+ · Directive
proxy
Next.js Proxy runs code before a request finishes. It can redirect, rewrite, change headers, or return a response, and a matcher can limit it to selected paths.
Last updated
- Since
- Next.js 16
Syntax
export function proxy(request: NextRequest, event?: NextFetchEvent) { ... }
export const config = { matcher: '/path/:path*' }In-depth API docs are only for subscribers: parameters, examples, common mistakes and interview practice.
SubscribeRelated
NextRequestNextResponseNextFetchEventmatcherredirectswaitUntilskipTrailingSlashRedirectskipProxyUrlNormalize