Introduction
Smart commits allows your team to perform actions on Jira issues from a single commit. Users can enter the issue key and the desired action such as time tracking or closing an issue.
The Git Integration for Jira app, the smart commit processing is active by default and can be enabled/disabled via the repository configuration:
Smart commits configuration checklist:
- The Jira DVCS Connector Plugin is not required.
- Your Jira e-mail address and Git commit e-mail address matches.
- E-mail address is not shared by other Jira users.
The basic syntax for a smart commit message is:
<ISSUE_KEY> <ignored text> #<command> <optional command_params>
Did You Know?
Jira User
The committers’ email address in the git configuration must match with the email address of the corresponding Jira user (or vice versa) for the smart commit to work.
Project Permissions
The Jira user must have the appropriate project permissions to transition issues.
Workflow Transition
When you hover a status on the Issue Workflow – it will highlight available transitions. This is the transition name that is used in Smart Commits.
Email Notifications
If a smart commit fails, an email notification is sent to either the Jira user, or to the Git user if a Jira user cannot be identified.
Transition Names
To avoid conflict when transitioning issues, give a unique name to a workflow transition.
Smart Commit Helper
When the Smart Commits setting is disabled for that repository, the Git Integration for Jira app will not show the COMMIT indicators.
Multi-line Commits
The Git Integration for Jira app support multi-line commit messages for smart commits.
Smart Commit Status
The commit status shown on the Issue page depends on the Smart Commits setting that was set at the time the commits were processed.
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 (this page)
Associate Pull/Merge Requests to Issues Based on Commits (Git Integration for Jira Data Center)
Creating branches (Git Integration for Jira Data Center)
Creating pull/merge requests (Git Integration for Jira Data Center)
Issue Git integration panel – Features (Git Integration for Jira Data Center)
