Project settings

From the Vercel dashboard, there are two areas where you can configure settings:

• Team Settings: Any settings configured here, are applied at the team-level, although you can select which project's the settings should be set for.
• Project Settings: These are specific settings, accessed through the project dashboard, that are only scoped to the selected project. You can make changes about all areas relating to your project, including domains, functions, drains, integrations, Git, caching, environment variables, deployment protection, and security.

This guide focuses on the project settings. To edit project settings:

1. Ensure you have selected your Team from the scope selector.
2. Choose a project from the dashboard.
3. Select the Settings tab.
4. Find the settings you need and make changes.

While many settings can be set from the dashboard, you can also define a vercel.json file at the project root that allows you to set and override the default behavior of your project.

To learn more, see Configuring projects with vercel.json.

This provides all the foundational information and settings for your Vercel project, including the name, build and deployment settings, the directory where your code is located, the Node.js version, Project ID, toolbar settings, and more.

To learn more, see General Settings

In your build and deployment settings, adjust configurations such as framework settings, code directory, and Node.js version.

In this section, you can adjust build-related configurations, such as framework settings, code directory, Node.js version, and more.

• Node.js version
• Prioritize production builds
• On-demand concurrent builds

By default, Vercel creates a new deployment and build (unless the Build Step is skipped) for every commit pushed to your connected Git repository.

Each commit in Git is assigned a unique hash value commonly referred to as SHA. If the SHA of the commit was already deployed in the past, no new Deployment is created. In that case, the last Deployment matching that SHA is returned instead.

To ignore the build step:

1. Choose a project from the dashboard
2. Select the Settings tab and then select the Build and Deployment menu item
3. In the Ignored Build Step section, select the behavior you would like. This behavior provides a command that outputs a code, which tells Vercel whether to issue a new build or not. The command is executed within the Root Directory and can access all System Environment Variables:
   • Automatic: Each commit will issue a new build
   • Only build production: When the VERCEL_ENV is production, a new build will be issued
   • Only build preview: When the VERCEL_ENV is preview, a new build will be issued
   • Only build if there are changes: A new build will be issued only when the Git diff contains changes
   • Only build if there are changes in a folder: A new build will be issued only when the Git diff contains changes in a folder that you specify
   • Don't build anything: A new build will never be issued
   • Run my Bash script: Run a Bash script from a location that you specify
   • Run my Node script: Run a Node script from a location that you specify
   • Custom: You can enter any other command here, for example, only building an Nx app (npx nx-ignore <project-name>)
4. When your deployment enters the BUILDING state, the command you've entered in the Ignored Build Step section will be run. The command will always exit with either code 1 or 0:
   • If the command exits with code 1, the build continues as normal
   • If the command exits with code 0, the build is immediately aborted, and the deployment state is set to CANCELED

To learn about more advanced usage see the "How do I use the Ignored Build Step field on Vercel?" guide.

If you have set an ignore build step command or script, you can also skip the build step when redeploying your app:

1. From the Vercel dashboard, select your project
2. Select the Deployments tab and find your deployment
3. Click the ellipses (...) and from the context menu, select Redeploy
4. Uncheck the Use project's Ignore Build Step checkbox

You can add custom domains for each project.

To learn more, see the Domains documentation

You can configure Environment Variables for each environment directly from your project's settings. This includes linking Shared Environment Variables and creating Sensitive Environment Variables

To learn more, see the Environment Variables documentation.

In your project settings, you can manage the Git connection, enable Git LFS, and create deploy hooks.

To learn more about the settings, see Git Settings. To learn more about working with your Git integration, see Git Integrations.

To manage third-party integrations for your project, you can use the Integrations settings.

To learn more, see Integrations.

Protect your project deployments with Vercel Authentication and Password Protection, and more.

To learn more, see Deployment Protection.

You can configure the default settings for your Vercel Functions, including the Node.js version, memory, timeout, region, and more.

To learn more, see Configuring Functions.

You can enable and disable Cron Jobs for your project from the Project Settings. Configuring cron jobs is done in your codebase.

To learn more, see Cron Jobs.

Team owners can manage who has access to the project by adding or removing members to that specific project from the project settings.

To learn more, see project-level roles.

Webhooks allow your external services to respond to events in your project. You can enable them on a per-project level from the project settings.

To learn more, see the Webhooks documentation.

Drains are a Pro and Enterprise feature that allow you to send observability data (logs, traces, speed insights, and analytics) to external services. Drains are created at the team-level, but you can manage them on a per-project level from the project settings.

To learn more, see the Drains documentation.

From your project's security settings you can enable or disable Attack Challenge Mode, Logs and Source Protection, Customer Success Code Visibility Git Fork Protection, and set a retention policy for your deployments.

To learn more, see Security Settings.

Vercel provides some additional features in order to configure your project in a more advanced way. This includes:

• Displaying directory listing
• Enabling Skew protection