To deploy on Vercel, you need to create a Project. A Project is a logical structure that groups deployments and custom domains. Each project can be associated to a GitHub, GitLab, or Bitbucket repository.
Creating a Project
You can create a new project from the Vercel Dashboard by clicking on the New Project button.
You can either import from an existing Git repository or use one of our templates.
Project Settings
To edit project settings, choose a project from the dashboard:
Then, select the Settings tab:
General Settings
Project Name
Project names can only consist of up to 100 alphanumeric lowercase characters. Hyphens can be used in between the name, but never at the start or end.
Build & Development Settings and Root Directory
You can edit build and development settings as well as the root directory settings. Check out our Build Step documentation to learn more.
Environment Variables
You can configure Environment Variables directly from Project Settings. Check out the Environment Variables documentation to learn more.
Install Command
Learn more about the default Install Command (and how to use the Project Settings to define a custom one) in our Build Step documentation.
Only applied starting from your next deployment
As with other project settings, the changes you make to this setting will only be applied starting from your next deployment.
Custom Domains
You can add custom domains for each project. Check out our Custom Domains documentation to learn more.
Git
To edit your project’s Git settings, select the Git menu item from your project settings page.
If you haven’t connected Vercel with GitHub, GitLab, or Bitbucket yet, you can do so from here.
Next, find the Git repository by choosing the respective Git namespace from the dropdown and searching for the name of the Git repository. Then, click on the Connect button to connect your project to the Git repository.
Once your project has been connected to a Git repository, you will see it from the settings.
If you’d like to disconnect your project from a Git repository, click on the Disconnect button.
Deploy Hooks
Vercel supports deploy hooks, which are unique URLs that accept HTTP POST requests and trigger deployments. Check out our Deploy Hooks documentation to learn more.
Security Settings
To edit your project’s security settings, select the Security menu item from your project settings page.
Ignored Build Step
By default, Vercel will issue a new Deployment with Build (unless the Build Step is skipped) for every commit to your connected Git repository.
If the SHA of the commit was already deployed in the past, however, no new Deployment is created. In that case, the last Deployment matching that SHA is returned instead.
To customize the behavior for your Git repositories, you can enter a command in the Ignored Build Step section of the Git page, which will then determine whether or not a new Build needs to be issued:
If the SHA of your commit wasn't deployed before, a regular Deployment is issued in the QUEUED
state, which then moves into the BUILDING
state once it starts building.
While the Deployment is in the BUILDING
state, the command you've entered in the Ignored Build Step section will be run. If the command exits with code 1
, the Build will continue as usual. If the command exits with code 0
, however, the Build is immediately aborted and the Deployment state is set to CANCELED
.
The command is executed within the Root Directory.
Logs and Source Protection
By default, the paths mentioned below can only be accessed by you and members of your Vercel Team. Turning off Logs and Source Protection will make them publicly accessible.
/_src
: Displays the source code and build output./_logs
: Displays the build logs.
This setting is overwritten when a Deployment is created using Vercel CLI with the --public
option or the public
property in vercel.json
.
--public
flag was passed when creating those Deployments.Password Protection
By using Password Protection, you can ensure that visitors of your Preview Deployments must enter a password in order to gain access.
Teams can opt into using this feature by enabling it from the "Optional" badge and paying $150 per month. Once you opt in, you can use it across other projects in the same team:
Protecting Preview Deployments
To use this feature, turn on the toggle and specify the visitor password.
After clicking Save, all Preview Deployments (existing and future ones) of this project will immediately be protected with a password. If you try to access the page, you’ll be presented with this screen:
After entering the password, the visitor will be redirected to the deployment. Also, a cookie will be set in the visitor’s browser, giving them access to all Preview Deployments of the project.
Protecting Production Deployments
To protect Production Deployments in addition to Preview Deployments, check “Also protect my Production Deployment" and click Save.
Details
- If you change the password, visitors who have previously entered the password (and therefore have the cookie set) will need to re-enter the password.
- If you disable the protection, all existing deployments of the project will become unprotected.
- If you disable the protection and then enable it, visitors who have the cookie set will continue to be able to access the deployments without re-entering the password.
- You can use Password Protection in conjunction with SSO Protection.
To bypass the protection programmatically, please read this.
Disabling the Feature
To opt out from this feature, you can do so from your team’s Settings → Billing page. Click Edit next to Password Protection and follow the instructions:
SSO Protection
By using SSO Protection, you can ensure that visitors of your Preview Deployments must log in with a personal Vercel account that is a member of your team to gain access.
Teams can opt into using this feature by clicking the "Optional" badge and contacting our sales team.
Protecting Preview Deployments
Once your team has access to the feature, turn on the toggle to enable it.
After clicking Save, all Preview Deployments (existing and future ones) will immediately require logging in with a personal Vercel account, and the account must be a member of your team. If you try to access the page, you’ll be presented with this screen:
If a visitor logs in with a personal Vercel account that’s a member of your team, the visitor will be redirected to the deployment. Also, a cookie will be set in the visitor’s browser, giving them access to Preview Deployments.
Note: If you’ve also enabled Password Protection, the login UI will look like this:
Protecting Production Deployments
To protect Production Deployments in addition to Preview Deployments, check “Also protect my Production Deployment" and click Save.
Details
- If you disable the protection, all existing deployments of the project will become unprotected.
- If you disable the protection and then enable it, visitors who previously logged into the deployment with Vercel will continue to be able to access the page without logging in again.
- If an account is removed from the team, then that account can no longer be used to access the deployment. The cookie will also become invalid.
- You can use SSO Protection in conjunction with Password Protection.
Deleting a Project
To delete a project, choose a project from the dashboard:
Then, select the Settings tab:
Next, select Advanced from the menu.
You’ll see the Delete Project section. Confirm that you'd like to delete the project and click the Delete button.