Jira development panel (FREE)

Moved from GitLab Premium to GitLab Free in 13.4.

You can use the Jira development panel to view GitLab activity for a Jira issue directly in Jira. To set up the Jira development panel:

For an overview, see Jira development panel integration.

Feature availability

This table shows the features available with the Jira DVCS connector and the GitLab for Jira Cloud app:

Feature Jira DVCS connector GitLab for Jira Cloud app
Smart Commits {check-circle} Yes {check-circle} Yes
Sync merge requests {check-circle} Yes {check-circle} Yes
Sync branches {check-circle} Yes {check-circle} Yes
Sync commits {check-circle} Yes {check-circle} Yes
Sync existing data {check-circle} Yes {check-circle} Yes
Sync builds {dotted-circle} No {check-circle} Yes
Sync deployments {dotted-circle} No {check-circle} Yes
Sync feature flags {dotted-circle} No {check-circle} Yes
Sync interval Up to 60 minutes Real time
Create branches {dotted-circle} No {check-circle} Yes (GitLab SaaS only)
Create merge request from branch {check-circle} Yes {check-circle} Yes
Create branch from Jira issue {dotted-circle} No {check-circle} Yes (introduced in GitLab 14.2)

Connected projects in GitLab

The Jira development panel connects a Jira instance with all its projects to the following:

Information displayed in the development panel

You can view GitLab activity for a Jira issue in the Jira development panel by referring to the Jira issue by ID in GitLab. The information displayed in the development panel depends on where you mention the Jira issue ID in GitLab.

GitLab: where you mention the Jira issue ID Jira development panel: what information is displayed
Merge request title or description Link to the merge request
Link to the branch (introduced in GitLab 15.11)
Branch name Link to the branch
Commit message Link to the commit
Jira Smart Commit Custom comment, logged time, or workflow transition

Jira Smart Commits


  • You must have GitLab and Jira user accounts with the same email address or username.
  • The commands must be in the first line of the commit message.
  • The commit message must not span more than one line.

Jira Smart Commits are special commands to process a Jira issue. With these commands, you can use GitLab to:

  • Add a custom comment to a Jira issue.
  • Log time against a Jira issue.
  • Transition a Jira issue to any status defined in the project workflow.

Smart Commits must follow this syntax:

<ISSUE_KEY> <ignored text> #<command> <optional command parameters>

You can execute one or more commands in a single commit.

Smart Commit syntax

Commands Syntax
Add a comment KEY-123 #comment Bug is fixed
Log time KEY-123 #time 2w 4d 10h 52m Tracking work time
Close an issue KEY-123 #close Closing issue
Log time and close an issue KEY-123 #time 2d 5h #close
Add a comment and transition to In-progress KEY-123 #comment Started working on the issue #in-progress

For more information about how Smart Commits work and what commands are available to use, see:


To troubleshoot the Jira development panel on your own server, see the Atlassian documentation.