For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Header control

Modify the headers of HTTP requests and responses.

Configuration options

You can configure the header modifier filter at two levels:

• HTTPRoute: For the native way in Kubernetes Gateway API, configure a header modifier filter in the HTTPRoute. You can choose to apply the header modifier filter to all the routes that are defined in the HTTPRoute, or to a selection of backendRefs. This route-level policy takes precedence over any TrafficPolicy that you might configure. For more information, see the Kubernetes Gateway API docs.
• TrafficPolicy (Envoy-based kgateway proxy only): For more flexibility to reuse the header modifier filter across HTTPRoutes, specific routes and Gateways, configure a header modifier filter in the TrafficPolicy. You can attach a TrafficPolicy to a Gateway, all HTTPRoutes via targetRefs, or an individual route via extensionRef. To attach to a backendRef, use a header modifier filter in the HTTPRoute instead. For more information about attachment and merging rules, see the TrafficPolicy concept docs.

Guides