Project Configuration
Vercel automatically detects your framework and sets sensible defaults for builds, deployments, and routing. Project configuration lets you override these defaults to control builds, routing rules, function behavior, scheduled tasks, image optimization, and more.
Each method lets you control different aspects of your project.
- Static file-based configuration - Static JSON configuration in your repository
- Static TOML configuration - Static TOML configuration in your repository
- Programmatic file-based configuration - Dynamic TypeScript configuration that runs at build time
- Global CLI configuration - System-wide Vercel CLI settings
Copy page
In addition to configuring your project through Project Settings, you have the following options:
File-based configuration
Property
vercel.json
vercel.ts
The table below shows all available configuration properties:
Description
bunVersion
Schedule functions to run at specific times
cleanUrls
Configure function memory, duration, and runtime
buildCommand
headers
Configure image optimization
functions
installCommand
Make deployment logs and source publicly accessible
ignoreCommand
devCommand
framework
outputDirectory
bulkRedirectsPath
Route requests to different paths or external URLs
rewrites
redirects
trailingSlash
regions
Configuration areas
Last updated August 25, 2026
Global CLI configuration
For detailed information about specific configuration areas, see:
vercel.json
Global Configuration affects how Vercel CLI behaves on your machine. These settings are stored in your user directory and apply across all projects.
Cross-link map: Project Configuration (/docs/project-configuration)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 pagesProject settings — Use the project settings, to configure custom domains, environment variables, Git, integrations, deployment protection,General settings — Configure basic settings for your Vercel project, including the project name, build and development settings, root direcGlobal Vercel CLI Configuration — Learn how to configure Vercel CLI under your system user.Static Configuration with vercel.toml — Configure your Vercel project with a TOML file using the same properties as vercel.json.Projects overview — A project is where you deploy and operate frontend apps, APIs, backends, containers, and agent workloads on Vercel.This page links to (9)General settings — Configure basic settings for your Vercel project, including the project name, build and development settings, root direcGit Configuration — Learn how to configure Git for your project through vercel.json or vercel.ts.Git settings — Use the project settings to manage the Git connection, enable Git LFS, and create deploy hooks.Global Vercel CLI Configuration — Learn how to configure Vercel CLI under your system user.Project settings — Use the project settings, to configure custom domains, environment variables, Git, integrations, deployment protection,Security settings — Configure security settings for your Vercel project, including Logs and Source Protection, Vercel Support Code VisibilitStatic Configuration with vercel.json — Learn how to use vercel.json to configure and override the default behavior of Vercel from within your project.Static Configuration with vercel.toml — Configure your Vercel project with a TOML file using the same properties as vercel.json.Programmatic Configuration with vercel.ts — Define your Vercel configuration in vercel.ts with @vercel/config for type-safe routing and build settings.Pages that link here (28)By site: vercel-changelog (5) · vercel-kb (10) · vercel-docs (13)From vercel-changelogNew configuration overrides available per-deploymentSupport for now.json will be removed on March 31, 2026Transform rules are now available in vercel.jsonIntroducing vercel.ts: Programmatic project configurationWeb Application Firewall control now available with vercel.jsonFrom vercel-kbCan I redirect from a subdomain to a subpath? — Learn how to redirect from your subdomain to a subpath on Vercel with a vercel.json file or with Next.jsCan I route based on letter casing on Vercel? — Information on whether or not it is possible to route based on letting casing with Vercel.Does Vercel support Ruby on Rails applications? — Learn how you can use Ruby on Rails with your frontend on Vercel.How can I increase the limit of redirects or use dynamic redirects on Vercel? — Instructions on how to use Serverless Functions to handle redirects on Vercel.How can I serve multiple projects under a single domain? — Learn how to serve multiple Vercel projects from a single domain.How do I perform Vercel redirects based on query strings? — When using redirects with the \vercel.json\\ or \next.config.js\\ configuration file, your URL may contain query paramHow to Configure the Cache-Control Response Header in Vercel Projects — After reviewing this guide, you will be able to set a cache-control header of any value to be returned when a specific pHow to enable CORS on Vercel — Learn how to enable CORS on Vercel with vercel.json, Routing Middleware, framework config, and route handlers, plus howHow to migrate from Fastly to Vercel with zero downtime — Consolidate your CDN infrastructure on Vercel to reduce latency, simplify your configuration, and improve your developerMigrate to Vercel from Cloudflare — Migrate your website's configuration from Cloudflare Pages or Workers to VercelFrom vercel-docsCron Jobs — Learn about cron jobs, how they work, and how to use them on Vercel.Troubleshooting Build Errors — Learn how to resolve common scenarios you may encounter during the Build step, including build errors that cancel a deplFluid compute — Learn about fluid compute, an execution model for Vercel Functions that provides a more flexible and efficient way to ruSvelteKit on Vercel — Deploy SvelteKit applications to Vercel and configure the adapter, rendering, streaming, ISR, analytics, and Routing MidAdvanced Configuration — Learn how to add utility files to the /api directory, and bundle 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.Building Integrations with Vercel REST API — Learn how to use Vercel REST API to build your integrations and work with redirect URLs.Integrating Vercel and Kubernetes — Deploy your frontend on Vercel alongside your existing Kubernetes infrastructure.Project settings — Use the project settings, to configure custom domains, environment variables, Git, integrations, deployment protection,Transferring a project — Learn how to transfer a project between Vercel teams.Configuration Redirects — Learn how to define static redirects in your framework configuration or vercel.json with support for wildcards, patternManaging redirects at scale — Add, bulk upload, version, and roll back project-level redirects using the CLI.
Was this helpful?