Default branch name configuration in Git - Step-by-Step Execution

Process Flow - Default branch name configuration

Start

↓

Check global config for default branch

↓

Is default branch set?

No→Use 'master' as default

|Yes↓

Use configured default branch name

↓

Create new repo or init branch

↓

Default branch set

↓

End

This flow shows how Git checks for a configured default branch name and uses it when creating new repositories or branches.

Execution Sample

Git

git config --global init.defaultBranch main
git init myrepo
cd myrepo
git branch

Set default branch to 'main', initialize a repo, and list branches to see the default branch name.

Process Table

Step	Command	Action	Result	Notes
1	git config --global init.defaultBranch main	Set global default branch name	Config updated: init.defaultBranch=main	Sets default branch to 'main' for new repos
2	git init myrepo	Initialize new repo	Repository created with default branch 'main'	Uses configured default branch name
3	cd myrepo	Change directory	In 'myrepo' folder	Ready to run git commands
4	git branch	List branches	main	Shows default branch is 'main'
5	git config --global --unset init.defaultBranch	Remove default branch config	Config removed	Reverts to default 'master'
6	cd .. && git init anotherrepo && cd anotherrepo	Initialize new repo	Repository created with default branch 'master'	No config, uses 'master'
7	git branch	List branches	master	Default branch is 'master' now

💡 Execution stops after showing branch names for repos with and without default branch config.

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 6	Final
init.defaultBranch	unset	main	main	unset	unset
current_repo_default_branch	none	none	main	master	master

Key Moments - 2 Insights

Why does the default branch change from 'master' to 'main' after setting the config?

Because after step 1 sets init.defaultBranch to 'main', git init (step 2) uses this config to create the default branch named 'main' instead of the old default 'master'. See execution_table rows 1 and 2.

What happens if the default branch config is removed?

After removing the config at step 5, git init (step 6) falls back to the default 'master' branch name. This is shown in execution_table rows 5 and 6.

Visual Quiz - 3 Questions

Look at the execution table, what is the default branch name after step 2?

A master

B main

C develop

D feature

💡 Hint

Check the 'Result' column in row 2 of the execution_table.

At which step is the default branch config removed?

A Step 3

B Step 6

C Step 5

D Step 7

💡 Hint

Look for the command 'git config --global --unset init.defaultBranch' in the execution_table.

If you set init.defaultBranch to 'develop', what would be the default branch after git init?

A develop

B master

C main

D feature

💡 Hint

The default branch matches the configured name as shown in steps 1 and 2.

Concept Snapshot

git config --global init.defaultBranch <name>
Sets the default branch name for new repositories.
If unset, default is 'master'.
git init uses this config to name the first branch.
Changing this helps align with modern branch naming conventions.

Full Transcript

This visual execution shows how Git uses the init.defaultBranch configuration to set the default branch name when creating new repositories. First, the global config is set to 'main'. Then, initializing a repo creates the 'main' branch instead of 'master'. Removing the config resets the default to 'master'. Listing branches confirms the branch names at each step. This helps beginners see how Git picks the default branch name based on config.