Anything related to issue must be placed inside issue cycle like this:

Where {{foreach[issue in issues]}} is start of the cycle, and {{/foreach}} is the end.

Fields

To insert fields in a template, please use the following syntax:

Custom fields look like this:

It's better to insert field, using our Template editor which allows to pick the required field from the list.

Formatting

Some fields can be formatted depending on field's type. Date and date time fields are formatted with Java Date Time pattern like this:

If formatting is not specified default format from settings will be used. 

Number fields can be formatted with Java DecimalFormat pattern.

Iterating lists

Sometimes, Jira data is a list of multiple objects. For instance, 'comment' and 'work log'.

To be able to insert such data, it must be placed inside a cycle.

In example above, worklogs is the list. The code will take issue worklogs one by one, and temporary store it under name worklog. Then it will display timeSpent property of the worklog. As a result, time spent will be shown for all the issue worklogs.

Example of comment:

There are two custom field types that must be placed inside a cycle: Labels and Select List (multiple choices). They are basically lists of text fields. In general, they will look like this:

Page break

You can insert page brake at certain point of the document. 

If you are using Template editor it can be done by clicking 'Page break'.

Extension methods

You can group, sort, and perform other sequential data manipulations in template expressions. See Extension methods for more.

Common templates for different field types

User

Comment

Worklog

Progress