gitlab-org--gitlab-foss/doc/gitlab-basics/create-branch.md

---
stage: Create
group: Source Code
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
type: howto
---

# How to create a branch

A branch is an independent line of development in a [project](../user/project/index.md).

When you create a new branch (in your [terminal](start-using-git.md) or with
[the web interface](../user/project/repository/web_editor.md#create-a-new-branch)),
you are creating a snapshot of a certain branch, usually the main `master` branch,
at its current state. From there, you can start to make your own changes without
affecting the main codebase. The history of your changes will be tracked in your branch.

When your changes are ready, you then merge them into the rest of the codebase with a
[merge request](../user/project/merge_requests/creating_merge_requests.md).
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`---`
Add latest changes from gitlab-org/gitlab@master 2020-07-29 08:09:45 -04:00			`stage: Create`
			`group: Source Code`
Add latest changes from gitlab-org/gitlab@master 2020-11-26 01:09:20 -05:00			`info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`type: howto`
			`---`

added new doc about creating a new branch 2015-07-09 18:33:42 -04:00			`# How to create a branch`

First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`A branch is an independent line of development in a [project](../user/project/index.md).`
added Fork Project document 2015-07-21 18:45:12 -04:00
Add latest changes from gitlab-org/gitlab@master 2020-09-28 02:09:56 -04:00			`When you create a new branch (in your [terminal](start-using-git.md) or with`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`[the web interface](../user/project/repository/web_editor.md#create-a-new-branch)),`
			you are creating a snapshot of a certain branch, usually the main `master` branch,
Add latest changes from gitlab-org/gitlab@master 2020-10-15 14:08:43 -04:00			`at its current state. From there, you can start to make your own changes without`
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`affecting the main codebase. The history of your changes will be tracked in your branch.`
Reference the web editor docs in GitLab basics "Create a branch" 2016-10-11 01:21:47 -04:00
First pass to bring /gitlab-basics to SSoT standards Removes duplicated information, and combines sections and files together when they are duplicated or highly related. Also adds intros to all pages and sections missing intros, and troubleshooting sections to pages that may need them in the future. Links more to other docs, and clarifies language when abosolutely necessary, and adds angle brackets to sample parameters. 2019-07-30 01:02:59 -04:00			`When your changes are ready, you then merge them into the rest of the codebase with a`
Add latest changes from gitlab-org/gitlab@master 2020-09-28 02:09:56 -04:00			`[merge request](../user/project/merge_requests/creating_merge_requests.md).`