Git Configuration

Learn how to configure Git for your project through the vercel.json file.

The following configuration options can be used through a vercel.json file like the Project Configuration.

Type: Object of key branch identifier String and value Boolean, or Boolean.

Default: true

Specify branches that should not trigger a deployment upon commits. By default, any unspecified branch is set to true.

vercel.json
{
  "git": {
    "deploymentEnabled": {
      "dev": false
    }
  }
}

Use minimatch syntax to define behavior for multiple branches.

The example below prevents automated deployments for any branch that starts with internal-.

vercel.json
{
  "git": {
    "deploymentEnabled": {
      "internal-*": false
    }
  }
}

If a branch matches multiple rules and at least one rule is true, a deployment will occur.

vercel.json
{
  "git": {
    "deploymentEnabled": {
      "experiment-*": false,
      "*-dev": true
    }
  }
}

A branch named experiment-my-branch-dev will create a deployment.

To turn off automatic deployments for all branches, set the property value to false.

vercel.json
{
  "git": {
    "deploymentEnabled": false
  }
}

Type: Boolean.

When set to false, Vercel for GitHub will not apply the alias upon merge.

vercel.json
{
  "github": {
    "autoAlias": false
  }
}

Type: Boolean.

When set to false, Vercel for GitHub will always build pushes in sequence without cancelling a build for the most recent commit.

vercel.json
{
  "github": {
    "autoJobCancelation": false
  }
}

The github.silent property has been deprecated in favor of the new settings in the dashboard, which allow for more fine-grained control over which comments appear on your connected Git repositories. These settings can be found in the Git section of your project's settings.

Type: Boolean.

When set to true, Vercel for GitHub will stop commenting on pull requests and commits.

vercel.json
{
  "github": {
    "silent": true
  }
}

The github.enabled property has been deprecated in favor of git.deploymentEnabled, which allows you to disable auto-deployments for your project.

Type: Boolean.

When set to false, Vercel for GitHub will not deploy the given project regardless of the GitHub app being installed.

vercel.json
{
  "github": {
    "enabled": false
  }
}
Last updated on March 4, 2025