Skip to content
Netlify Docs

Start your next project with a prompt. → netlify.new 🚀

Branch deploys

Branch deploy controls

Section titled “Branch deploy controls”

You can set up a branch deploy for a specific branch or for all new branches in your repository through your project configuration.

By default, Netlify will not generate a branch deploy unless a Developer or Owner has set up branch deploys for your site.

Set up a branch deploy for specific branches

Section titled “Set up a branch deploy for specific branches”

To set up a branch deploy for one or more specific branches, such as staging or qa:

  1. Go to Project configuration Build & deploy Continuous Deployment Branches and deploy contexts, and select Configure.

  2. Select Let me add individual branches and enter the name of each branch you want to deploy. You can also enter branch names you haven’t created yet in your repository. To deploy all branches with a specific prefix, add an asterisk to the end of your branch name, e.g. features/*.

  3. To confirm, select Save.

Set up branch deploys for all new branches

Section titled “Set up branch deploys for all new branches”

To automatically generate branch deploys for every new branch pushed to your remote site repository:

  1. Go to Project configuration Build & deploy Continuous Deployment Branches and deploy contexts, and select Configure.

  2. Next to Branch deploys, select All. This excludes the designated production branch for your repository.

  3. To confirm, select Save.

Turn off all branch deploys for your site

Section titled “Turn off all branch deploys for your site”

To turn off all branch deploys for your site:

  1. Go to Project configuration Build & deploy Continuous Deployment Branches and deploy contexts, and select Configure.

  2. For Branch deploys, select None.

  3. To confirm, select Save.

Protect all branch deploys with a password

Section titled “Protect all branch deploys with a password”

You can control who can access your site’s branch deploys by requiring a password. Learn more at our Password Protection docs.

Use branch subdomains for branch deploys

Section titled “Use branch subdomains for branch deploys”

You can assign custom branch subdomains to your branch deploys using your site’s primary custom domain. Learn more about custom branch subdomains for branch deploys.