The key benefits of setting up a Git and Jira integration include:<\/p>\n\n\n\n
- \n
- Less context switching: <\/strong>You can seamlessly move from Jira to your Git app if needed, or you can just manage your Jira work items without leaving your Git platform. This is much more efficient and improves focus.<\/li>\n\n\n\n
- Transparency: <\/strong>This integration helps keep everything organized and transparent. A product manager can see what was done for each work item without leaving Jira. In turn, developers can gain more context for old code changes by checking which Jira tasks they are related to:<\/li>\n<\/ul>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/0-1-1024x774.png\")
<\/figure>\n\n\n\n- \n
- Better communication:<\/strong> Transparency facilitates more effective collaboration, especially for cross-functional processes. Getting necessary information is easier, leading to better alignment and organization among teams.\u00a0<\/li>\n\n\n\n
- Time optimization:<\/strong> As routine updates become automated, teams spend less time manually syncing statuses or adding links between Jira and Git.\u00a0<\/li>\n<\/ul>\n\n\n\n
These and other benefits are why this integration is so widely used. The value it delivers results in streamlined processes and increased productivity.<\/p>\n\n\n\n
How to Set Up a Git and Jira Integration for a Cloud Instance?<\/h2>\n\n\n\n
There are two main options:<\/p>\n\n\n\n
- \n
- Connect Git and Jira natively<\/strong>: Jira has a built-in Git connector, but it\u2019s only available for Bitbucket.<\/li>\n\n\n\n
- Use a Git app from the marketplace: <\/strong>Available for various platforms, including GitHub and GitLab.<\/li>\n<\/ul>\n\n\n\n
The process itself is straightforward. First, you need to install the integration app (except for Bitbucket) and connect your repositories. Then, link Git activity to Jira work items by using issue keys. After this, you will be able to view dev information in Jira tickets, use smart commits, and set up automation to further optimize your work. Let\u2019s explore this in detail.<\/p>\n\n\n\n
\n \nManage projects in the Cloud with Smart Checklist<\/h5>\n
Smart Checklist helps you organize your work with clear ToDo\u2019s. Create checklists, save them as templates, and apply them to recurring tasks with automation.<\/p> Try for free <\/a>\n <\/div>\n
\n![\"\"](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2020\/05\/Smart-Checklist_Jira-3.svg\")
\n <\/div>\n<\/section>\n\n\n\nInstall the Integration App and Connect Your Repositories<\/h3>\n\n\n\n
<\/p>\n\n\n\n
Bitbucket<\/strong><\/p>\n\n\n\n
For a native integration with Bitbucket, open your Jira project and navigate to Settings -> Products -> Integrations<\/strong> block, where you can find DVCS accounts<\/strong>. Then, connect your account and grant the requested permissions. Your repositories will be automatically connected to Jira.<\/p>\n\n\n\n
For other tools, use an app from the Atlassian marketplace.<\/p>\n\n\n\n
GitHub<\/strong><\/p>\n\n\n\n
Install GitHub for Jira<\/a> and connect your GitHub account. Select your organization and specify which GitHub repositories you want to link. This can be All repositories<\/strong> or Only select repositories<\/strong>. Grant the requested access permissions, allowing Jira to pull information from GitHub and vice versa.\u00a0<\/p>\n\n\n\n
GitLab<\/strong><\/p>\n\n\n\n
Once you have installed GitLab for Jira<\/a>, follow the wizard\u2019s prompts to complete the setup. Specify which version of GitLab you are using: for the cloud-hosted version, select GitLab.com. Then, sign in to GitLab and authorize GitLab for Jira. Once done, link your GitLab groups.<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/1-1-1024x923.png\")
<\/figure>\n\n\n\nTo complete the integration process, you will need administrator permissions, as well as the relevant permissions on your version control platform. For the most up-to-date information on the required permissions, it\u2019s best to review the requirements provided by your Git platform during the integration setup.<\/p>\n\n\n\n
Please note that this article focuses on the integration with the cloud versions of Git platforms. If you need to connect Jira to GitHub Enterprise Server, Self-managed GitLab, or Bitbucket Data Center, please refer to the official documentation.<\/p>\n\n\n\n
Link Your Git Activity to Jira Work Items<\/h3>\n\n\n\n
Even though your repositories are already connected, the synchronization with Jira may not be complete yet. To finalize this process, you need to link your Git activity to specific Jira issues (work items). This can be done by simply including Jira work item keys in your Git messages:<\/p>\n\n\n\n
- \n
- Commits<\/li>\n\n\n\n
- Branch names<\/li>\n\n\n\n
- Pull request titles and descriptions<\/li>\n<\/ul>\n\n\n\n
A work item key (or Jira issue key) is a combination of letters and numbers that serves as a work item identifier in Jira – for instance, TA-9082 or PROJ-123. You can find it at the top of a work item view. On your Jira board, it\u2019s at the bottom of the card.<\/p>\n\n\n\n
When you mention a work item key in your Git message, the system recognizes it, and the message is then associated with the work item it mentioned.<\/p>\n\n\n\n
For example, this can be a commit message like this one:<\/p>\n\n\n\n
git commit -m “TWM-93 <Fixed all bugs>”\u00a0<\/strong><\/p>\n\n\n\n
Information about this commit will be available in the Development section of the mentioned work item\u2019s view. You can link branches and pull\/merge requests to specific Jira work items in the same way.<\/p>\n\n\n\n
It\u2019s enough to use one work item key and push changes to the connected repository to complete the synchronization with Jira. After several minutes, it should be fully connected to your version control application. Needless to say, you can still use work item keys in your Git messages whenever you need to link an action to a Jira work item.<\/p>\n\n\n\n
View Development Information and Create Branches in Jira<\/h2>\n\n\n\n
You can monitor Git actions in Jira in several ways, each providing a different perspective. Let\u2019s have a look at these options.<\/p>\n\n\n\n
Check your repositories and pull requests from the Code tab<\/strong><\/p>\n\n\n\n
Once your Git and Jira integration is set up, the two apps will be fully synced. As a result, you will be able to see the connected repositories and the latest activity on the Code<\/strong> tab in the Development<\/strong> section in Jira:<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/2-1024x774.png\")
<\/figure>\n\n\n\nGet granular details from a work item view<\/strong><\/p>\n\n\n\n
In addition, you can view development information directly from your Jira work items. Open a work item view, which is an individual page for the selected Jira task, story, bug, etc. Find the Development <\/strong>section in the menu on the right, and click on any branch or commit message. <\/p>\n\n\n\n
In the pop-up window that appears, you will see the detailed development information:<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/3-1-1024x493.png\")
<\/figure>\n\n\n\nThis includes a list of commits with various details and a link to the repository. Additionally, there is information about the associated branches and pull requests. This is especially valuable for product managers, as they can easily see all the dev events linked to a specific work item.<\/p>\n\n\n\n
Monitor the overall progress from the Release Hub<\/strong><\/p>\n\n\n\n
If you have a company-managed project and work with fix versions in Jira, you can also track ticket statuses from the release hub. In the Jira project menu on the left pane, find Releases <\/strong>in the Development <\/strong>section. Select the release you need and scroll down to Issues\/Work Items<\/strong>. <\/p>\n\n\n\n
You will see Git statuses for each work item, if relevant. The status icons have different colors:<\/p>\n\n\n\n
- \n
- Green <\/strong>– there is a merged pull request for this ticket<\/li>\n\n\n\n
- Black<\/strong> – there is a pull request that is still waiting for review or approval<\/li>\n\n\n\n
- Blue<\/strong> – a branch has been created, but there is no pull request yet<\/li>\n\n\n\n
- No icon<\/strong> – there\u2019s no development activity for this work item<\/li>\n<\/ul>\n\n\n\n
![\"View](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/9-1-1024x774.png\")
<\/figure>\n\n\n\nCreate branches, commits, and pull requests from the work item view<\/strong><\/p>\n\n\n\n
In addition to monitoring Git information, you can also perform various actions directly from Jira. Open a work item view and navigate to the Development section. From there, you can create branches, commits, and pull requests. <\/p>\n\n\n\n
For example, to create a branch, select your source code integration from the dropdown and provide the required details: repository, branch from, and branch name. These steps are the same for both GitLab and GitHub integration.<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/4-1-1024x923.png\")
<\/figure>\n\n\n\nAlternatively, you can simply copy the text from the box, as shown below, and run this command in the terminal in your Git project. In this case, you don\u2019t need to specify any additional information, and the branch will be created more quickly.<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/5-1-1024x923.png\")
<\/figure>\n\n\n\nUse Smart Commits to Manage Jira Work from Your Git App<\/h2>\n\n\n\n
It\u2019s possible to make changes to Jira work items directly from a Git platform. This is done with the help of smart commits, which are commands included in commit messages. They enable you to perform actions such as:<\/p>\n\n\n\n
- \n
- Adding comments to the specified Jira work items<\/li>\n\n\n\n
- Recording time-tracking information<\/li>\n\n\n\n
- Changing an issue\u2019s workflow status \/ work item status<\/li>\n<\/ul>\n\n\n\n
This allows you, for example, to move Jira tickets from In progress to In review or Done without leaving your Git app, and so on. Once Jira is integrated with GitHub, GitLab, or Bitbucket, smart commits should be enabled by default. <\/p>\n\n\n\n
A smart commit message has the following syntax:<\/p>\n\n\n\n
<ignored text> <ISSUE_KEY> <ignored text> #<COMMAND> <optional COMMAND_ARGUMENTS><\/strong><\/p>\n\n\n\n
The system won’t consider parts of the message marked as ignored. In its simplest form, such a message can only consist of an issue key and a command, such as \u201cTA-095 #close\u201d or \u201cRW-123 #comment fixed.\u201d<\/p>\n\n\n\n
Here are the syntax formulas for each of the available commands:<\/p>\n\n\n\n
- \n
- #comment <comment_string><\/strong><\/li>\n\n\n\n
- #time <value>w <value>d <value>h <value>m <comment_string><\/strong><\/li>\n\n\n\n
- #<transition_name> #comment <comment_string><\/strong><\/li>\n<\/ul>\n\n\n\n
The <comment string> is an optional element for all commands except for the first one, #comment. When specifying the transition name, you need to provide a Jira issue status that is included in your team\u2019s Jira workflow (such as Ready for QA or Completed). If the status name has more than one word, replace spaces with hyphens, for example: #ready-for-qa.<\/p>\n\n\n\n
For more information, please refer to the official documentation<\/a>.\u00a0<\/p>\n\n\n\n
Using smart commits helps developers reduce context switching and enhances transparency.<\/p>\n\n\n\n
Monitor Git Activity on a Dashboard in Jira<\/h2>\n\n\n\n
For product managers, it\u2019s important to see the team\u2019s overall progress and analyze productivity. This allows them to identify bottlenecks, assess delivery speed, and spot potential problems in a timely manner.<\/p>\n\n\n\n
This can be achieved with the help of a productivity dashboard. Let\u2019s examine some of your options. <\/p>\n\n\n\n
A Native Development Dashboard<\/h3>\n\n\n\n
Jira now offers a built-in dashboard that helps you track various productivity metrics. It combines data from Jira and your version control platform. This is convenient as a product manager can see development activity directly from Jira.<\/p>\n\n\n\n
The dashboard includes a bar chart showing the number of work items completed per week. It also has scorecards with various metrics, such as overdue work, pull request cycle time, and vulnerabilities from the linked security containers. You can click the scorecards to open detailed graphs.<\/p>\n\n\n\n
![\"Git](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/6-1-1024x933.png\")
<\/figure>\n\n\n\nIn addition, the dashboard lists the latest Git activity and suggests recommendations for the next work items to focus on. <\/p>\n\n\n\n
To access this dashboard, navigate to the project settings -> Development -> Development (beta)<\/strong>.<\/p>\n\n\n\n
A Smart Productivity & Team Activity Dashboard<\/h3>\n\n\n\n
While the native dashboard provides a general overview, it lacks flexibility and detail. In particular, it doesn\u2019t help you analyze team performance in depth or track individual productivity. <\/p>\n\n\n\n
However, you can do this with a third-party plugin, Smart Productivity & Team Activity Dashboard<\/a> for Jira. It includes more metrics and can provide significant value to product managers.\u00a0<\/p>\n\n\n\n
The Smart Productivity Dashboard gathers data from Jira, Confluence, and GitHub, allowing you to:<\/p>\n\n\n\n
- \n
- Track key productivity metrics<\/strong>: The number of work items created and closed by assignees, the number of commits and PR data, productivity median by team, % of median for individual contributions, and more.\u00a0<\/li>\n\n\n\n
- Analyze individual performance<\/strong> using the Team filter on the Metrics breakdown tab. Select the person you need and specify other parameters to see their weekly performance by project, sprint, epic, and issue type \/ work item type.<\/li>\n\n\n\n
- Define role-based benchmarks<\/strong> and analyze individual contributions in comparison to the median for the person\u2019s role. For example, you will have different productivity criteria for a Developer and a Product Designer. A performance of less than 100% means it\u2019s below the guild median, and vice versa.<\/li>\n<\/ul>\n\n\n\n
<\/figure>\n\n\n\n
The charts can be configured to show performance insights by platform. This dashboard creates full transparency for product managers. It enables them to see how the team is performing at the project, epic, work, and sprint levels. This understanding is crucial for spotting bottlenecks, adjusting workloads, and improving efficiency.<\/p>\n\n\n\n
To start using it, install the Smart Productivity & Team Activity Dashboard<\/a> from the Atlassian Marketplace. For the dashboard to collect data correctly, you will also need to have a Git and Jira integration set up. For more details on creating and using your Smart Dashboard, see our article “How to calculate productivity in Jira<\/a>.”\u00a0<\/p>\n\n\n\n
\n - Analyze individual performance<\/strong> using the Team filter on the Metrics breakdown tab. Select the person you need and specify other parameters to see their weekly performance by project, sprint, epic, and issue type \/ work item type.<\/li>\n\n\n\n
- #time <value>w <value>d <value>h <value>m <comment_string><\/strong><\/li>\n\n\n\n
- #comment <comment_string><\/strong><\/li>\n\n\n\n
- Black<\/strong> – there is a pull request that is still waiting for review or approval<\/li>\n\n\n\n
- Green <\/strong>– there is a merged pull request for this ticket<\/li>\n\n\n\n
- Use a Git app from the marketplace: <\/strong>Available for various platforms, including GitHub and GitLab.<\/li>\n<\/ul>\n\n\n\n
- Time optimization:<\/strong> As routine updates become automated, teams spend less time manually syncing statuses or adding links between Jira and Git.\u00a0<\/li>\n<\/ul>\n\n\n\n
- Transparency: <\/strong>This integration helps keep everything organized and transparent. A product manager can see what was done for each work item without leaving Jira. In turn, developers can gain more context for old code changes by checking which Jira tasks they are related to:<\/li>\n<\/ul>\n\n\n\n
![\"smart](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/02\/Property-1Smart-Dashboard-jira.svg\")
\n <\/div>\n<\/section>\n\n\n\n![\"Install](\"https:\/\/titanapps.io\/blog\/wp-content\/uploads\/2025\/04\/7-1-1024x774.png\")
<\/figure>\n\n\n\n