content/issues/tracking-your-work-with-issues/using-issues/creating-a-branch-for-an-issue.md

metadata

title: Creating a branch to work on an issue
intro: >-
  You can create a branch to work on an issue directly from the issue page and
  get started right away.
versions:
  fpt: '*'
  ghes: '*'
  ghec: '*'
allowTitleToDifferFromFilename: true
topics:
  - Issues
shortTitle: Create branch for issue
redirect_from:
  - /issues/tracking-your-work-with-issues/creating-a-branch-for-an-issue

The ability to create a branch for an issue is currently in {% data variables.release-phases.public_preview %} and subject to change.

About branches connected to an issue

Branches connected to an issue are shown under the "Development" section in the sidebar of an issue. When you create a pull request for one of these branches, it is automatically linked to the issue. The connection with that branch is removed and only the pull request is shown in the "Development" section. For more information, see AUTOTITLE.

Creating a branch for an issue

Anyone with write permission to a repository can create a branch for an issue. You can link multiple branches for an issue.

By default, the new branch is created in the current repository, and from the default branch.

{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %}

1. In the list of issues, click the issue that you would like to create a branch for.

2. In the right sidebar under "Development", click Create a branch. If the issue already has a linked branch or pull request, select {% octicon "gear" aria-label="Development" %} and click Create a branch.

   

3. Optionally, in the "Branch name" field, type a branch name.

4. Optionally, select the Repository destination dropdown menu, then choose a repository.

5. Under "What's next", select whether you want to work on the branch locally or to open the branch in {% data variables.product.prodname_desktop %}.

6. Click Create branch.