How to set upstream branch in Git

Łukasz Holeczek Follow Łukasz Holeczek on GitHub Connect with Łukasz Holeczek on LinkedIn Follow Łukasz Holeczek on X (Twitter)

Friday, February 6, 2026

#git #upstream #branches #remote

Setting an upstream branch establishes a tracking relationship between your local branch and a remote branch, allowing you to use git push and git pull without specifying the remote and branch name. As the creator of CoreUI with 25 years of Git experience managing distributed teams, I use upstream branches daily for streamlined workflows.

The most effective command is git push -u origin branch-name which pushes and sets upstream in one operation.

Direct Answer

Use the -u flag when pushing to set upstream:

git push -u origin feature-branch

After Creating a New Branch

When you create a new local branch:

git checkout -b feature-login
git push -u origin feature-login

Set Upstream for Existing Branch

If you already pushed without -u:

git branch --set-upstream-to=origin/feature-branch

Short form:

git branch -u origin/feature-branch

Push and Set Upstream

For the current branch:

git push --set-upstream origin $(git branch --show-current)

Default Push Behavior

Configure Git to automatically set upstream:

git config --global push.autoSetupRemote true

Now git push automatically sets upstream on first push.

Check Upstream Status

View which branches have upstream configured:

git branch -vv

Output shows tracking information:

* feature-login  a1b2c3d [origin/feature-login] Add login form
  main           d4e5f6g [origin/main: ahead 2] Latest changes

Remove Upstream

Unset upstream tracking:

git branch --unset-upstream

Set Different Upstream

Track a different remote branch:

git branch -u origin/develop

Explanation

The upstream branch is the default remote branch for fetching and pushing. Setting it once with -u means you can use git push and git pull without arguments. Git stores this configuration in .git/config as branch.<name>.remote and branch.<name>.merge.

Best Practice Note

This is the same upstream workflow we use in CoreUI’s repositories with hundreds of contributors. Setting upstream on the first push with -u saves typing and prevents errors from pushing to the wrong branch. The push.autoSetupRemote config (Git 2.37+) automates this completely.

Related Articles

For related Git operations, check out how to prune remote branches in Git and how to change remote URL in Git.

Speed up your responsive apps and websites with fully-featured, ready-to-use open-source admin panel templates—free to use and built for efficiency.

Angular

Bootstrap

React.js

Vue.js

About the Author

Follow Łukasz Holeczek on GitHub Connect with Łukasz Holeczek on LinkedIn Follow Łukasz Holeczek on X (Twitter)

Łukasz Holeczek, Founder of CoreUI, is a seasoned Fullstack Developer and entrepreneur with over 25 years of experience. As the lead developer for all JavaScript, React.js, and Vue.js products at CoreUI, they specialize in creating open-source solutions that empower developers to build better and more accessible user interfaces.

With expertise in TypeScript, JavaScript, Node.js, and modern frameworks like React.js, Vue.js, and Next.js, Łukasz combines technical mastery with a passion for UI/UX design and accessibility. CoreUI’s mission is to provide developers with tools that enhance productivity while adhering to accessibility standards.

Łukasz shares its extensive knowledge through a blog with technical software development articles. It also advises enterprise companies on building solutions from A to Z. Through CoreUI, it offers professional services, technical support, and open-core products that help developers and businesses achieve their goals.

Learn more about CoreUI’s solutions and see how your business can benefit from working with us.