Git Integration for Jira Cloud Documentation

Contact support

Smart commits

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.

Getting started

The smart commit processing is active by default and can be enabled/disabled via the repository settings:

  • Manage integrations page Git repo type Actions Edit integration Feature settings.

  • Manage repositories page Actions Edit repository Feature settings.

In Jira Cloud, Smart Commits is a toggle setting
in the repository settings.

Smart commits support for project keys that has an underscore “_” character.
Smart commits support for all alphabet characters.
Smart commits support for case-insensitive smart commits.

Smart commits configuration checklist:

  • The Jira DVCS Connector Plugin is not required.
    The Git Integration for Jira app has the functions of the connector plugin plus more integration support and features.

  • Your Jira e-mail address and Git commit e-mail address matches. IMPORTANT
    The commit author’s email should match exactly with a user’s email in Jira. If they do not match, the application will add the commit as the app.

  • E-mail address is not shared by other Jira users.
    Verify that this email address is used by only one Jira user.

  • Advanced: Verify that the workflow conditions and validators are able to process successfully.

The Git Integration app supports smart commit by adding a simple syntax to a commit message.

The basic syntax for a Smart commit message is:

<ISSUE_KEY> <ignored text> #<command> <optional command_params>

To know more about syntax, commands and examples on Smart Commits, see Processing Jira Software Issues with Smart Commit Messages at the Atlassian website or proceed to the next page.

See next topics below

Linking git commits to Jira issues

Smart commit: Basic commands

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