Setting a system-wide default branch name

Administering Bitbucket Server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The default branch for a repository is its integration branch for work. In pull request workflows, its where feature branches are targeted. It's also the first branch created in a new repository.

As a Bitbucket Server administrator, you can select how this branch is named by going to  > Default branch name. On this page your options are:

On this page:

Related pages:

OptionDescription
Use the Git default name

The name given to the default branch is based on the installed Git version:

  • In Git 2.27 and below, the default name is hard-coded as master.

  • In Git 2.28+, the default name is master, but can be configured.

Set a custom default nameYou can set an set an instance-wide custom default name for this branch. This custom name will be used instead of the Git name, and when a user creates a new repository they’ll see it prefilled in the default branch name field. They can then use this name, or enter a branch name of their own.

When creating a new repository, users can leave the Default branch name field empty. If they do, the name given to the default branch will be the default branch name that has been configured for the instance.

Last modified on Nov 17, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.