Adding issue operation links to the email

SINCE VERSION 6.1

Jira Email This Issue allows you to include issue operation links in the email body. All you need to do is to select Operation Links in the Field Picker dropdown in the email template editor.

In the HTML editor, you can add a placeholder in your email template for the operation links:

Rendering links

When you include the above mentioned template fragments, Email This Issue will use the following code to render the operation links. If you want to customize how operation links are rendered, change layout or styles, include the following codeblock directly in your template and tailor it to your needs.

Example template codeblock rendering links in HTML emails

#set ($transitions = $!jetiFieldRenderer.getWorkflowActions($!issue))
#if ($!transitions && $!transitions.size() > 0)
#foreach($transition in $!transitions)
<a style="border-left:1px solid #ccc; padding:4px 10px; float:left;" href="$baseurl/secure/WorkflowUIDispatcher.jspa?id=$issue.id&action=$!transition.id">$!transition.name</a>
#end
#end

Example template codeblock rendering links in Text emails

#set ($transitions = $!jetiFieldRenderer.getWorkflowActions($!issue))
#if ($!transitions && $!transitions.size() > 0)
#foreach($transition in $!transitions)
$stringUtils.leftPad($!transition.name, $padSize): $baseurl/secure/WorkflowUIDispatcher.jspa?id=$issue.id&action=$!transition.id
#end
#end

Important: Form token errors will occur!

Jira has protection against various web security vulnerability, like CSS, XSRF etc. Jira uses form tokens in each links it exposes. These tokens are uniquely generated for each request/response. Read more details in the Jira documentation.

We cannot provide a workaround for this token checking, this means when you open an operation link from email, you'll see an error screen even if you have a running session in your browser.

When the following error message is shown, simply click Retry Operation to execute the operation. You may still need to log in. After all these the operation will be called and you can proceed with the transition.

Last updated