Page tree
Skip to end of metadata
Go to start of metadata

If you link your DVCS repositories to JIRA using the JIRA DVCS connector, you can use the smart commits feature to transition JIRA issues through a workflow (for example, Close, Fixed, and so forth). You can transition issues to any status defined in a JIRA projects' workflow. You can also comment on issues and record time tracking information against issues. To use this feature:

  • You must configure  smart commits on JIRA for your DVCS accounts.
  • Committers' email address in Bitbucket or GitHub must match the email address of the corresponding user in JIRA. 
  • The JIRA user must have the appropriate project permissions to transition issues.

If smart commits are enabled and you want to know how to use them, see Processing JIRA issues with commit messages for details.

Configure Smart Commits

By default, all new repositories added to your linked account have the smart commits feature enabled. You can disable or enable the smart commits feature on individual repositories. You can also configure if newly added repositories have this feature enabled by default or not.

Enable or Disable Smart Commits for a Repository

Open JIRA in your browser and do the following:

  1. Log in as a user with administrative permissions.
  2. Go to the Manage DVCS Accounts page.
    • For on-premises JIRA, go to Administration > Plugins > Source Control > DVCS Accounts.
    • For OnDemand sites, from the JIRA dashboard click the  (settings) icon and choose System. Then, select Source Control > DVCS Accounts.
  3. Check or uncheck the Smart Commits option on a repository. 

Configure smart commits for new repositories added to an account

You can configure if smart commits are enabled for new repositories by default on an account basis. 

  1. Log into JIRA as a user with administrative rights.
  2. Go to the Manage DVCS Accounts page.
    • For on-premises JIRA, go to Administration > Plugins > Source Control > DVCS Accounts.
    • For OnDemand sites, from the JIRA dashboard click the  (settings) icon choose System. Then, select Source Control > DVCS Accounts.
  3. Click the the  (settings) icon for the account.
  4. Click the Enable smart commits on new repositories.

Forks and smart commits

If you use forks in your workflow, the DVCS connector records each repository that contains a smart commit message. It actually processes the smart commit message only the first time it encounters it.  When you view the commit tab in JIRA, you can see which forks include that particular commit: