Creating branches

Introduction

The Create branch feature offers Jira users the ability to create a git branch directly from the Jira issue.

For information about creating pull/merge requests from a Jira issue – see article Creating pull/merge request.

Advantages

When creating a branch from within Jira:

• Automatically populates branch name with issue key (necessary for branch ⇿ Jira issue association) and issue summary.

• Further – default branch naming conventions can be customized to match your development workflow.

  For example:
  ${issuetype:New Issue,new,Bug Fix,bug}/${issuekey}-${summary} generates bug/PRJ-123-add-more-logging

  See General settings for more information.

• Require each Jira user to provide their Personal Access Token for creating branches. This option adds some friction to creating branches/pull requests but enabling this setting will enforce the git server user permissions as well as give better attribution for the actions.

  For more information, see Require Personal Access Tokens for user actions (create branch/pull request) for more information.

Supported platforms

• Full feature (Auto-Connect) integrations:

  • GitHub

  • GitLab

  • AWS CodeCommit

  • Azure DevOps

  • Microsoft Visual Studio Team Services (VSTS)

  • Microsoft Team Foundation Server (TFS)

Steps to creating a git branch in Jira

1. Prerequisite: Jira administrator configures a a full feature integration (auto-connect) via Add new integration panel in the Git Integration for Jira Data Center app. See Integration Guides for more information.

2. To access the Create branch action, do one of the following:

   1. Open/expand the Git Development panel.

   2. If not visible or displayed, enable in General settings.

3. Click Create branch in one of the panels from step 2.

4. Select git repository. Use the search box to look for the specific name of the repository that will be used.

5. If a personal access token is required (and not yet provided) – follow on screen instructions to provide a personal access token with correct permissions for selected repository.

6. Select base branch.

7. Verify branch name is correct. Edit as desired.
   Note: The Jira issue key must remain in the branch name to create the branch ⇿ Jira issue association.

8. Click Create branch.

Video: Creating branch via Git Development panel

(UPDATED VIDEO COMING SOON)

If you still have a question – reach out to our Support Desk or email us at [email protected].

See more Git Integration for Jira app features

Manager permissions (Git Integration for Jira Data Center)

Cancel indexing (Git Integration for Jira Data Center)

Pull request filters (Git Integration for Jira Data Center)

Tag filters (Git Integration for Jira Data Center)

Indexing queue viewer (Git Integration for Jira Data Center)

Deep linking feature (Git Integration for Jira Data Center)

GitHub App integration (Git Integration for Jira Data Center)

Git Integration + ScriptRunner (Git Integration for Jira Data Center)

Git Integration + Jira Automation (Git Integration for Jira Data Center)

Enforced git permissions for Jira users – Features (Git Integration for Jira Data Center)

Shared reindex queue between DC nodes (Git Integration for Jira Data Center)

Smart commits overview (Git Integration for Jira Data Center)

Associate Pull/Merge Requests to Issues Based on Commits (Git Integration for Jira Data Center)

Creating branches (this page)

Creating pull/merge requests (Git Integration for Jira Data Center)

Issue Git integration panel – Features (Git Integration for Jira Data Center)