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?
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.
The Jira user must have the appropriate project permissions to transition issues.
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.
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.
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.
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.