Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support: Server  
Contact Support: Data Center  

Smart commits overview


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>

For more information on the Smart Commits feature, see Documentation: Smart commits.

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.

Related topic »

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.

Need to know more?  Read further at  Documentation: Smart commits.

Have feedback about this article? Did we miss something? Let us know!
On this page