Git Integration for Jira. See Git commits in Jira.
What’s on this page:
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 smart commit processing is active by default and can be enabled/disabled via the Repository settings (Apps ➜ Git Integration: Manage integrations ➜ Actions ➜ Edit integration ➜ click a repository ➜ Feature settings):
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>
Using the format above, the smart commit structure will actually look like this:
TST-123 #comment fixed bug #time
1h 30m Bug fixes
In the above example, the commit is associated to TST-123, adds the comment "fixed bug" to the Issue ➜ Comment tab, logs the time of 1 hour and 30 minutes with worklog comment "Bug fixes" to the Jira issue.
For multi-line commit messages, the following examples show correct usage of the smart commit message:
TST-1 implemented feature 1
on several lines
The above example is a valid multi-line commit message.
#label command will add a new label to a Jira issue. If more than one Jira issue is referenced, the labels are added to all mentioned Jira issues. Multiple labels can be created by putting spaces between words.
GITCL-443 GITCL-247 GITCL-214 #label
email@example.com firstname.lastname@example.org requested-feature new-feature #comment
Return email when implemented
In the above example:
The labels email@example.com, firstname.lastname@example.org, requested-feature and new-feature are applied to Jira issues GITCL-443, GITCL-247 and GITCL-214. Also, the comment is added to each of the mentioned Jira issues.
The name of the status is the transition. So, for the example above, the valid transitions from DONE are:
Open an issue and click View Workflow from the context of the issue (near the issue’s Status).
Hover a status.
Smart Commits General Setting
Max commit age
JIRA CLOUD DEV INFO
This setting is a hidden feature in Git Integration for Jira Cloud and Dev Info for Jira Cloud. All commits which are older than this setting (in seconds) shall be ignored for smart commits processing.
The default value is 1209600 seconds (14 days).
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.
The Git Integration for Jira app, support for multi-line commit messages for Smart Commits has been implemented.
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.