• Connected projects in GitLab
• Information displayed in the panel
• Jira Smart Commits
• Configure the panel
  • For GitLab.com
  • For self-managed GitLab
• Troubleshooting

Jira development panel

The Jira development panel connects all GitLab projects in a group or personal namespace where you can view GitLab activity.

When you’re in GitLab, you can refer to a Jira issue by ID. The activity for that issue is displayed in the Jira development panel.

In the Jira development panel, you can create a GitLab merge request from a branch. You can also create a GitLab branch from a Jira issue in the GitLab for Jira Cloud app (introduced in GitLab 14.2).

Connected projects in GitLab

The Jira development panel connects to the entire Jira instance all GitLab projects in:

• A top-level group, including all projects in its subgroups.
• A personal namespace.

These GitLab projects can interact with all Jira projects in that instance.

Information displayed in the panel

The information displayed in the Jira 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 GitLab 15.11 and later: Link to the branch
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

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.

For more information, see the Atlassian documentation.

Configure the panel

For an overview, see Jira development panel integration.

For GitLab.com

Prerequisite:

• You must have at least the Maintainer role for the group.

To configure the Jira development panel on GitLab.com:

• For Jira Cloud:
  • From the Atlassian Marketplace, install the GitLab for Jira Cloud app.
  • This method syncs data between GitLab.com and Jira in real time.
  • This method requires inbound connections for the setup and outbound connections to push data to Jira.
  • For more information, see GitLab for Jira Cloud app.
• For Jira Server:
  • Use the Jira DVCS connector.
  • This method syncs data every hour and works only with inbound connections.
  • This method attempts to set up webhooks in GitLab to sync data in real time, which requires outbound connections.

For self-managed GitLab

Prerequisites:

• You must have administrator access to the instance.
• Your GitLab installation must not use a relative URL (for example, https://example.com/gitlab).

To configure the Jira development panel on self-managed GitLab:

• For Jira Cloud:
  • Install the GitLab for Jira Cloud app manually.
  • This method requires inbound connections for the setup and outbound connection to push data to Jira.
  • For more information, see Connect the GitLab for Jira Cloud app for self-managed instances.
• For Jira Server:
  • Use the Jira DVCS connector.
  • This method syncs data every hour and works only with inbound connections.
  • This method attempts to set up webhooks in GitLab to sync data in real time, which requires outbound connections.

Troubleshooting

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