How to Push a Branch to Remote in Git: Simple Steps

To push a branch to a remote in Git, use the command git push <remote-name> <branch-name>. This sends your local branch changes to the remote repository so others can access them.

Syntax

The basic syntax to push a branch to a remote repository is:

• git push: The command to send changes to a remote.
• <remote-name>: The name of the remote repository, usually origin.
• <branch-name>: The name of the local branch you want to push.

bash

git push <remote-name> <branch-name>

Example

This example shows how to push a local branch named feature1 to the remote called origin. It uploads your branch so others can see and use it.

bash

git push origin feature1

Output

Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 350 bytes | 350.00 KiB/s, done.
Total 3 (delta 2), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
To github.com:user/repo.git
 * [new branch]      feature1 -> feature1

Common Pitfalls

Common mistakes when pushing branches include:

• Using the wrong remote name (usually it is origin).
• Trying to push a branch that does not exist locally.
• Not having permission to push to the remote repository.
• Forgetting to create the branch locally before pushing.

Always check your branch name with git branch and remote names with git remote -v.

bash

git push origin master
# Wrong if your branch is named 'feature1'

git push origin feature1
# Correct if 'feature1' exists locally

Quick Reference

Here is a quick cheat sheet for pushing branches:

Command	Description
git push origin feature1	Push local branch 'feature1' to remote 'origin'
git push origin main	Push local 'main' branch to remote
git branch	List local branches
git remote -v	Show remote repository names and URLs
git push -u origin feature1	Push and set upstream tracking for 'feature1'

Key Takeaways

Use git push <remote> <branch> to send a local branch to a remote repository.

The remote name is usually origin, but verify with git remote -v.

Make sure the branch exists locally before pushing it.

Use git push -u to set the remote branch as the default upstream for easier future pushes.

Check for permission issues if push fails.