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

Contact Support
GitKraken Status  

Smart commits – Viewing workflows

Accessing the View workflow feature on the Issue page requires a user or user group to have the View Read-Only Workflow project permissions.

You can see the available custom workflow transition commands for use with smart commits by doing the following:

  1. Open an issue and click View Workflow from the context of the issue (near the issue’s Status).

  2. Hover a status.

    When you hover a status – it will highlight available transitions. This is the transition name that is used in smart commits and not the status name.

Below is an example using the above workflow where the issue is in OPEN status and want to send it to BUSINESS SPEC status:

<ISSUE_KEY> #to-business-spec or,
<ISSUE_KEY> #to-business and even,
<ISSUE_KEY> #to (yes, this works, as long as it does not conflict with another transition name)

Do note that invalid characters can be used in the transition name. Jira accepts most of them and they can be used. However, smart commits will only process letters and dash characters.

Thus, the part of the transition name up to the invalid character can be used for transitions; where spaces become “-“.


Example 1:

Transition name Smart Commit transition

There must be at least one unique way to call each transition name. If you have multiple transition names from a single status that use the same word, the smart commits will fail.


Example 2:

Another example, where an issue status NEW has these two transition paths:


The invalid characters are used before unique transition names are possible. Both will become “#SEND“. Therefore, they are not unique and these transitions will fail.


Example 3:

Finally, the transition names have spaces instead:


Both of these transitions are smart commit-friendly and the possible transitions are:

  • #SEND-TO-D...
  • #SEND-TO-B...

The “…” indicates the truncation with the least character length to have the transition names be recognized as unique by Smart Commits. Any length shorter than this will fail the transition as explained in Example 2 above.

If a smart commit fails, an email notification is sent to either the Jira user, or to the Git user if a Jira user can’t be identified.


Prev: Workflow transitions

Next: Smart commits helper

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