Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP C C++ C# AWS W3.CSS HOW TO BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING INTRO TO HTML & CSS BASH RUST TOOLS

Git Tutorial

Git HOME Git Intro Git Install Git Config Git Get Started Git New Files Git Staging Git Commit Git Remove and Move Git Tagging Git Stash Git History Git Diff Git Blame Git Help Git Branch Git Merge Git Workflow Git Best Practices

Git and GitHub

GitHub Get Started Git What is SSH? GitHub Add SSH GitHub Set Remote GitHub Edit Code Pull from GitHub Push to GitHub GitHub Branch Pull Branch from GitHub Push Branch to GitHub GitHub Flow GitHub Pages Git GUI Clients

Git Contribute

GitHub Fork Git Clone from GitHub GitHub Send Pull Request

Git Undo

Git Revert Git Reset Git Clean Git Amend Git Rebase Git Reflog Git Recovery

Git Advanced

Git .gitignore Git .gitattributes Git Large File Storage (LFS) Git Signing Commits/Tags Git Cherrypick & Patch Git Bisect Git Merge Conflicts Git CI/CD Git Hooks Git Submodules Git Worktree Git Remote Advanced

Git and Bitbucket

Bitbucket Get Started Bitbucket Add SSH Bitbucket Set Remote Bitbucket Edit Code Bitbucket Branch Bitbucket Pages Bitbucket Fork Git Clone from Bitbucket Bitbucket Send Pull Request

Git and GitLab

GitLab Get Started GitLab Add SSH GitLab Set Remote GitLab Edit Code GitLab Branch GitLab Pages GitLab Fork Git Clone from GitLab GitLab Send Pull Request

Git Cert

Git Certificate

Git Reference

Git Glossary

Git Exercises

Git Exercises Git Challenges Git Quiz Git Syllabus Git Study Plan

Git Push Branch to GitHub


Share

Push Branch to GitHub

This chapter explains how to push a branch from your local computer to GitHub.


Push a Branch to GitHub

Let's create a new local branch, make a change, and push it to GitHub.

Example

git checkout -b update-readme
Switched to a new branch 'update-readme'
Try it Yourself »

Edit a file, then check the status:

Example

git status
On branch update-readme
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   README.md

no changes added to commit (use "git add" and/or "git commit -a")
Try it Yourself »

Add and commit your changes:

Example

git add README.md
git commit -m "Update readme for GitHub"
Try it Yourself »

Push your branch to GitHub:

Example

git push origin update-readme
Try it Yourself »

GitHub New Branch



Push and Set Upstream

Use this if your branch doesn't exist on GitHub yet, and you want to track it:

Example

git push --set-upstream origin update-readme
Try it Yourself »

Force Push

Warning: This overwrites the branch on GitHub with your local changes. Only use if you understand the risks.

Example

git push --force origin update-readme
Try it Yourself »

Delete Remote Branch

Remove a branch from GitHub:

Example

git push origin --delete update-readme
Try it Yourself »

Push All Branches

Push all your local branches to GitHub:

Example

git push --all origin
Try it Yourself »

Push Tags

Push all your tags to GitHub:

Example

git push --tags
Try it Yourself »

Troubleshooting

  • Rejected push (non-fast-forward): Someone else pushed changes before you. Run git pull --rebase first, then try again.
  • Authentication failed: Make sure you are logged in and have permission to push to the repository.
  • Remote branch not found: Double-check the branch name and spelling.



Free account

Track your progress

XP earned 0 Day streak 0 Spaces 0 League —

New

Learn in Adventure Mode W3Schools Adventure App

Coding fundamentals as bite-sized lessons and challenges.

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookies and privacy policy.

Copyright 1999-2026 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.