Linking Projects with Vercel CLI

When running vercel in a directory for the first time, Vercel CLI needs to know which team and Vercel Project you want to deploy your directory to. You can choose to either link an existing Vercel Project or to create a new one.

After you pick a team, the CLI searches that team for an existing project that matches your local directory name (after slugifying). If it finds one, it offers to link to it directly. Otherwise it falls through to the manual selection flow shown later in this page.

vercel
 
  Set up "~/web/my-lovely-project"
? Which team? My Awesome Team
? Found project "awesome-team/my-lovely-project". Link to it? [Y/n] y
  Linked      awesome-team/my-lovely-project

If no project matches the directory name (or you choose not to link to the suggestion), the CLI falls back to a manual prompt:

vercel
 
  Set up "~/web/release-notes"
? Which team? My Awesome Team
? Link to existing project? [y/N] y
? Existing project name? marketing-site
  Linked      awesome-team/marketing-site

Once set up, a new .vercel directory is added to your directory. The .vercel/project.json file contains the orgId and projectId of your Vercel Project. To unlink your directory, remove the .vercel directory.

You can use the --yes option to skip these questions.

When you create a new Vercel Project, Vercel CLI links the Vercel Project and automatically detects the framework you are using and offers default Project Settings accordingly.

vercel
 
  Set up "~/web/my-new-project"
? Which team? My Awesome Team
? Link to existing project? [y/N] n
? Name? my-new-project
  Detected Next.js (Build Command: next build, Output Directory: Next.js default)
? Customize settings? [y/N]

The status line shows Build Command and Output Directory inline. If you answer y to Customize settings?, the CLI presents a checklist for overriding the detected settings (Build Command, Development Command, Output Directory). You can continue with the defaults or override them now; you can also edit settings later in your Vercel Project dashboard.

• deploy
• link