Deleting remote branches in Git - Step-by-Step Execution

Process Flow - Deleting remote branches

Identify branch to delete

↓

Run git push origin --delete branch

↓

Git contacts remote repository

↓

Remote deletes the branch

↓

Confirm deletion success

↓

Local branch remains unless deleted separately

This flow shows how you delete a branch from a remote Git repository by pushing a delete request, then the remote removes the branch.

Execution Sample

Git

git push origin --delete feature-xyz

Deletes the remote branch named 'feature-xyz' from the 'origin' repository.

Process Table

Step	Command Part	Action	Result
1	git push	Start push process	Local Git prepares to send data
2	origin	Specify remote repository	Git targets 'origin' remote
3	--delete feature-xyz	Request remote branch deletion	Remote receives delete request for 'feature-xyz'
4	Remote processes request	Remote deletes branch if it exists	Branch 'feature-xyz' removed from remote
5	Confirmation	Remote sends success message	Local Git shows deletion success message

💡 Branch 'feature-xyz' deleted on remote; local branch unaffected

Status Tracker

Variable	Start	After Step 3	After Step 4	Final
Remote Branch 'feature-xyz'	Exists	Delete requested	Deleted	Deleted

Key Moments - 2 Insights

Why does the local branch still exist after deleting the remote branch?

Deleting a remote branch only removes it from the remote repository. The local branch stays until you delete it manually. See execution_table step 5 where deletion success is confirmed but local branch is not changed.

What happens if the branch does not exist on the remote?

Git will show an error or warning that the branch was not found on the remote. The deletion request fails at step 4 in the execution_table.

Visual Quiz - 3 Questions

Look at the execution table, at which step does the remote actually delete the branch?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Check the 'Action' and 'Result' columns at step 4 in the execution_table.

According to the variable tracker, what is the state of the remote branch after step 3?

A Exists

B Delete requested

C Deleted

D Unknown

💡 Hint

Look at the 'Remote Branch' row under 'After Step 3' in variable_tracker.

If you want to remove the branch locally after deleting it remotely, what should you do?

A Run 'git branch -d branch-name'

B Run 'git push origin branch-name'

C Run 'git fetch origin'

D Run 'git clone origin'

💡 Hint

Local branch deletion is separate; see key_moments about local branch remaining.

Concept Snapshot

Deleting remote branches:
Use 'git push origin --delete branch-name' to remove a branch from remote.
This does NOT delete your local branch.
Remote confirms deletion with a success message.
If branch doesn't exist remotely, Git shows an error.
Local branch must be deleted separately with 'git branch -d branch-name'.

Full Transcript

To delete a remote branch in Git, you run the command 'git push origin --delete branch-name'. This tells Git to contact the remote repository named 'origin' and request deletion of the specified branch. The remote repository processes this request and deletes the branch if it exists. Git then confirms the deletion with a success message. Note that this command only deletes the branch on the remote; your local copy of the branch remains until you delete it manually using 'git branch -d branch-name'. If the branch does not exist on the remote, Git will show an error message indicating the branch was not found. This process helps keep the remote repository clean by removing branches that are no longer needed.