Reference

Project settings

Use the project settings, to configure custom domains, environment variables, Git, integrations, deployment protection, functions, cron jobs, project members, webhooks, log drains, and security settings.
Table of Contents

From the Vercel dasboard, 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, log 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

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 manage your build step settings.

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.

Log drains are a Pro and Enterprise feature that allows you to send logs to external services. Log 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 Log 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:

Last updated on October 18, 2024