Skip to content
masterclass Buddy

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.

Subscribe
  • NextRequest
  • NextResponse
  • NextFetchEvent
  • matcher
  • redirects
  • waitUntil
  • skipTrailingSlashRedirect
  • skipProxyUrlNormalize

Source: Proxy. Checked 2026-11-03.