GitHub to Use ‘Main’ Instead of ‘Master’ as the Default Branch on All New Repositories Starting Next Month

In August, GitHub announced that it would change the “master” branch name for all new repositories created on the platform to “main” starting October 1. The date is less than two weeks away, and WordPress developers need to be prepared for the change if they use the service for version control or project management.

The larger tech and web development community began conversations through various venues in June, a time in which the Black Lives Matter was gaining more traction in the U.S. and worldwide. The discussion centered on removing any terminology that could be discriminatory or oppressive to specific groups of people. This ongoing discussion has shown that there is a deep division over whether such changes are necessary or even helpful.

The WordPress community is dealing with this division itself. Aaron Jorbin proposed a change at the same time to rename the default branch name on WordPress-owned repositories. Through discussion on his post and elsewhere, the community landed on “trunk,” which keeps WordPress projects in line with its SVN roots.

“To close the circle on this, a decision was made in June and earlier today (August 19),” wrote Helen Hou-Sandí, a lead WordPress developer, in the comments of the original proposal. “I updated the default branch name for new GitHub repositories under the WordPress organization to be trunk after GitHub enabled early access to that feature.”

As evidenced by the comments on the Tavern’s coverage of the proposal and those on the original post, the WordPress development community as a whole did not support this decision.

Jorbin has updated several of WordPress’s repositories and switched them to use trunk instead of master. However, there are still some lingering projects yet to be updated, including the primary WordPress and WordPress Develop repositories. He left a comment with an updated list in June. There is no public word on whether the existing, leftover projects will be changed.

WordPress Developer Preparations

Setting a custom default branch on GitHub.
Customizing the default branch for a user’s GitHub repositories.

GitHub is merely changing the default branch name for new repositories starting on October 1. This change does not affect existing repositories. Individual users, organization owners, and enterprise administrators can customize the default branch via their account settings now before the switch is made. Owners can also change the default branch name for individual repositories.

The biggest thing that developers need to watch out for is their tooling or other integrations that might still require the master branch. There may be cases where an alternative default branch name will break workflows. If planning to use a different branch name, the best thing to do right now is to spin up the tools you use on a test repository. If something breaks, check to see whether the particular tool you are using will be getting an update. In most cases, this should not be a problem because customized default branch names will be an industry standard.

The great thing about how GitHub is rolling out this feature is that it offers a choice. Those who believe that “master” is oppressive can change the branch name to something they feel is more inclusive. For those who believe otherwise, they can keep their master branch. But, everyone can use the branch name they prefer.

For existing repositories, GitHub is asking that developers be patient for now. The company is investing in tools to make this a seamless experience later this year. There are a few technical hurdles to clear first.

Developers should read the full GitHub guide on setting the default branch for more information.


4 responses to “GitHub to Use ‘Main’ Instead of ‘Master’ as the Default Branch on All New Repositories Starting Next Month”

  1. The tech industry is full of virtue signaling crap. The removal of the use of the word master does not solve anything not that there is anything to solve in the first place. The amount of crap that American white guilt forces upon the rest of the world is astonishing.

    Trunk is a pretty crappy name for the master branch in the first place, it does not convey what it is in a good way. Master is much better than trunk. But I suppose using the same bad name everywhere is an improvement, sort of.

      • Well the word master has nothing to do with slavery. Master as in having mastered a field, master record, master recording, master print, master’s degree. The word master has meanings well beyond slavery relationship. Not that master slave in databases has anything to do with master slave as in Arabic slave trade sense.
        I know this as a non-native English speaker, so it is fascinating that it is completely lost to US Americans.

  2. This is stupid and I am black. In development words are only used as the best description to what it is. Any layman (can I use that or should I say layperson) can figure out if something is a master and something is not which to mess with and which to leave alone.

    In development when I hear master and slave I think write and read, main and duplicate, os files and data files, ok to mess with, not ok to mess with. I do not think about the 1800’s or before. I do not think of black people in fields, cotton, or whips. I think in the context of which it is being used.

    This idea that people are so sensitive that we have to parse every word before speaking or typing is ridiculous.

    Even more interesting to me is when white people act as they know how I feel. Or, that they have to tell me how I feel. Oh, we have to change this because it’s offensive to minorities. I am a minority, it never crossed my mind.


Subscribe Via Email

Enter your email address to subscribe to this blog and receive notifications of new posts by email.