Middleware Patterns · Contentful Personalization · contentful/skills · Skills Docs

Skill 09 · Contentful Personalization

Subchapter 9.11

Middleware Patterns

references/middleware-patterns.mdMarkdown4 KBView on GitHub

Middleware is the most common source of setup failures. Treat matcher and cookie behavior as first-class design decisions.

Choose the Right Runtime Pattern

// middleware.ts (project root)
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  const response = NextResponse.next();
  // Forward ntaid cookie for personalization continuity
  const ntaid = request.cookies.get('ntaid');
  if (ntaid) {
    response.headers.set('x-ntaid', ntaid.value);
  }
  return response;
}

export const config = {
  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],
};