Skip to Content
System Headers

By using headers effectively, you can optimize the performance and security of your application on Vercel's global network. Here are some tips for using headers on Vercel:

Headers are small pieces of information that are sent between the client (usually a web browser) and the server. They contain metadata about the request and response, such as the content type, cache-control directives, and authentication tokens. HTTP headers can be found in both the HTTP Request and HTTP Response.


Using headers Copy page

  1. Use caching headers: Caching headers instruct the client and server to cache resources like images, CSS files, and JavaScript files, so they don't need to be reloaded every time a user visits your site. By using caching headers, you can significantly reduce the time it takes for your site to load.
  2. Use compression headers: Use the Accept-Encoding header to tell the client and server to compress data before it's sent over the network. By using compression, you can reduce the amount of data that needs to be sent, resulting in faster load times.
  3. Use custom headers: You can also use custom headers in your vercel.json file to add metadata specific to your application. For example, you could add a header that indicates the user's preferred language or the version of your application. See Project Configuration docs for more information.

Request headers

To learn about the request headers sent to each Vercel deployment and how to use them to process requests before sending a response, see Request headers.

Response headers

Cross-link map: System Headers (/docs/headers)From the Vercel docs graph (built 2026-09-21T05:26:59.511Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.jsonSemantically closest pagesResponse headers — Learn about the response headers sent to each Vercel deployment and how to use them to process responses before sendingCache-Control headers — Learn about the cache-control headers sent to each Vercel deployment and how to use them to control the caching behaviorSet cache control headers for functions — Learn how to set headers to cache your function's responses.How requests flow through Vercel — Learn how Vercel routes, secures, and serves requests from your users to your application.Vercel fundamental concepts — Learn about the core concepts of VercelThis page links to (6)Cache-Control headers — Learn about the cache-control headers sent to each Vercel deployment and how to use them to control the caching behaviorRequest headers — Learn about the request headers sent to each Vercel deployment and how to use them to process requests before sending aResponse headers — Learn about the response headers sent to each Vercel deployment and how to use them to process responses before sendingVercel CDN Compression — Vercel helps reduce data transfer and improve performance by supporting both Gzip and Brotli compressionStatic Configuration with vercel.json — Learn how to use vercel.json to configure and override the default behavior of Vercel from within your project.Set cache control headers for functions — Learn how to set headers to cache your function's responses.Pages that link here (24)By site: vercel-changelog (3) · vercel-kb (7) · vercel-web (1) · vercel-docs (13)From vercel-changelogEdge Functions are now generally availableEnhanced geolocation information for Vercel FunctionsIP Geolocation now available for all plansFrom vercel-kbMigrate to Vercel from Cloudflare — Migrate your website's configuration from Cloudflare Pages or Workers to VercelSet cache control headers for functions — Learn how to set headers to cache your function's responses.How to ship an Express app on Vercel — Deploy an Express app to Vercel with zero configuration. Configure response streaming, middleware, cron jobs, the Bun ruHow to ship a FastAPI app on Vercel — Deploy a FastAPI app to Vercel with zero configuration. Learn how the Python runtime, Vercel Functions, streaming, middlHow to ship a Flask app on Vercel — Deploy a Flask app to Vercel with zero configuration. Learn how to ship from a template, the Vercel CLI, or Git, and conHow to ship an H3 app on Vercel — Deploy an H3 app to Vercel with zero configuration. Learn to configure streaming, middleware, cron jobs, the Bun runtimeHow to ship a Hono app on Vercel — Deploy a Hono app to Vercel with zero configuration. Learn how to ship from a template, the Vercel CLI, or Git, and confFrom vercel-webVercel Edge Functions are now generally availableFrom vercel-docsVercel CDN Cache — Learn how Vercel's CDN cache stores your content across a global network to reduce latency and origin load.Express on Vercel — Deploy Express applications to Vercel with zero configuration. Learn about middleware and Vercel Functions.Deploy a Flask app on Vercel — Deploy a Flask app on Vercel. Learn how the Python runtime, WSGI, static assets, and Vercel Functions work together.Hono on Vercel — Deploy Hono applications to Vercel with zero configuration. Learn about observability, ISR, and custom build configuratiAstro on Vercel — Deploy Astro sites to Vercel and configure server-side rendering, ISR, Web Analytics, Image Optimization, and Routing MiLegacy Usage & Pricing for Functions — Learn about legacy usage and pricing for Vercel Functions.How Vercel builds your application — Learn how Vercel transforms your source code into optimized assets ready to serve globally.Glossary — Learn about the terms and concepts used in Vercel's products and documentation.Response headers — Learn about the response headers sent to each Vercel deployment and how to use them to process responses before sendingHow Vercel CDN works — Learn how Vercel's CDN processes requests through routing, caching, and compute layers to deliver your content with lowImage Optimization with Vercel — Transform and optimize images to improve page load performance.Static Configuration with vercel.json — Learn how to use vercel.json to configure and override the default behavior of Vercel from within your project.Programmatic Configuration with vercel.ts — Define your Vercel configuration in vercel.ts with @vercel/config for type-safe routing and build settings.

To learn about the response headers included in Vercel deployment responses and how to use them to process responses before sending a response, see Response headers.

Request Headers

To learn about the cache-control headers sent to each Vercel deployment and how to use them to control the caching behavior of your application, see Cache-Control headers.

Last updated August 11, 2026

Was this helpful?