Smart Values and Transformations

{{<fieldId>}}

Any field of the work item, by field ID.

{{summary}}, {{customfield_10050}}

{{key}}

Work item key.

PROJ-123

{{id}}

Work item ID (a number).

10423

{{now}}

Current date and time. Add a date function.

{{now.plusDays(1).jiraDate}}

{{value}}

Value of the field the mapping reads from. Only in field mappings, and only when that field is selected.

{{value.toUpperCase}}

{{issue}}

Full work item data as returned by the Jira REST API (advanced).

{{issue.fields.summary}}

{{source.<fieldId>}}

A field read only when the value travels from source to target. Empty when pulling.

{{source.customfield_10098}}

{{target.<fieldId>}}

A field read only when the value travels from target to source. Empty when pushing.

{{target.customfield_10098}}

{{comment}}

The comment being synced. Only in comment templates. See Comment paths below.

{{comment.body}}

assignee, reporter

accountId, displayName

Use accountId when writing to a user field.

creator

accountId, displayName

priority

name, id

Use name when writing to Priority.

issuetype

name, id

Use name when writing to Work type.

status, resolution, security

name, id

statusCategory

name, key, id

project

key, name, id

The work item's space.

parent

key, fields.summary

timetracking

originalEstimate, remainingEstimate, timeSpent, originalEstimateSeconds, remainingEstimateSeconds, timeSpentSeconds

The *Seconds properties are numbers.

votes

votes, hasVoted

watches

watchCount, isWatching

progress, aggregateprogress

progress, total, percent

Jira leaves out percent when there's no estimate.

Select, radio buttons, multi-select, checkboxes

value, id

Use value when writing.

Cascading select

value, id, child.value, child.id

User, multi-user

accountId, displayName

Use accountId when writing.

Group, multi-group

name

Version, multi-version

name, id

Use name when writing.

Project picker custom field

key, name, id

Use key when writing.

Team

id, title

{{comment.body}}

Comment text, as plain text.

{{comment.author.displayName}}

Author's name.

{{comment.author.accountId}}

Author's account ID.

{{comment.created}}, {{comment.updated}}

Dates. Add a date function, for example {{comment.created.jiraDate}}.

{{comment.id}}

Comment ID.

{{comment.visibility.type}}, {{comment.visibility.value}}

The comment's visibility restriction, if any.

{{comment.jsdPublic}}

false for an internal Jira Service Management comment.

Text, number

As is.

True or false

true or false.

List

Items joined with , (comma and space). Use join for another separator.

Object, for example a user or an option

Its first non-empty property of: displayName, name, value, key, id. So {{assignee}} renders the display name.

Rich text, for example description

Plain text. Formatting, images and other media aren't kept.

Empty, missing or unknown path

Nothing. See below.

format(pattern)

Format with a pattern. See Format patterns below.

{{created.format("DD/MM/YYYY")}}

21/08/2026

jiraDate

Date only.

{{created.jiraDate}}

2026-08-21

jiraDateTime

Date and time with time zone offset.

{{created.jiraDateTime}}

2026-08-21T10:30:00.000+0000

shortDate

Short date.

{{created.shortDate}}

21/Aug/26

shortDateTime

Short date and time.

{{created.shortDateTime}}

21/Aug/26 10:30 AM

longDate

Long date.

{{created.longDate}}

21 August 2026

longDateTime

Long date and time.

{{created.longDateTime}}

21 August 2026 10:30 AM

plusDays(n) / minusDays(n)

Add or subtract n days.

{{created.plusDays(3).jiraDate}}

2026-08-24

plusWeeks(n) / minusWeeks(n)

Add or subtract n weeks.

{{created.plusWeeks(2).jiraDate}}

2026-09-04

plusMonths(n) / minusMonths(n)

Add or subtract n months.

{{created.minusMonths(1).jiraDate}}

2026-07-21

plusYears(n) / minusYears(n)

Add or subtract n years.

{{created.plusYears(1).jiraDate}}

2027-08-21

plusHours(n) / minusHours(n)

Add or subtract n hours.

{{created.plusHours(2).hour}}

12

plusMinutes(n) / minusMinutes(n)

Add or subtract n minutes.

{{created.minusMinutes(30).hour}}

10

startOfMonth

Start of the month (day 1, 00:00).

{{created.startOfMonth.jiraDate}}

2026-08-01

endOfMonth

End of the month (last day, 23:59).

{{created.endOfMonth.jiraDate}}

2026-08-31

startOfWeek

Start of the week (Monday).

{{created.startOfWeek.jiraDate}}

2026-08-17

endOfWeek

End of the week (Sunday).

{{created.endOfWeek.jiraDate}}

2026-08-23

toStartOfDay

Start of the day (00:00).

{{created.toStartOfDay.hour}}

0

withDayOfMonth(n)

Set the day of the month.

{{created.withDayOfMonth(1).jiraDate}}

2026-08-01

withMonth(n)

Set the month (1 = January).

{{created.withMonth(12).jiraDate}}

2026-12-21

withYear(n)

Set the year.

{{created.withYear(2027).jiraDate}}

2027-08-21

dayOfMonth

Day of the month (1–31).

{{created.dayOfMonth}}

21

dayOfWeek

Day of the week (1 = Monday, 7 = Sunday).

{{created.dayOfWeek}}

5

dayOfWeekName

Day name.

{{created.dayOfWeekName}}

Friday

month

Month (1 = January).

{{created.month}}

8

year

Four-digit year.

{{created.year}}

2026

hour

Hour (0–23).

{{created.hour}}

10

minute

Minute (0–59).

{{created.minute}}

30

second

Second (0–59).

{{created.second}}

0

isAfter(date)

True if later than the given date.

{{created.isAfter("2026-01-01")}}

true

isBefore(date)

True if earlier than the given date.

{{created.isBefore("2026-01-01")}}

false

isEquals(date)

True if it's the same date and time.

{{created.isEquals("2026-08-21T10:30:00Z")}}

true

compareTo(date)

-1 if earlier, 0 if the same, 1 if later.

{{created.compareTo("2026-01-01")}}

1

diff(date)

Time from the given date to this date. Add .millis, .seconds, .minutes, .hours, .days, .weeks, .months, .years or .prettyPrint. Add .abs first to drop the sign, for example .abs.days.

{{now.diff(created).days}}

Whole days since the work item was created

YYYY, YY

2026, 26

MMMM, MMM, MM, M

August, Aug, 08, 8

DD, D

21, 21 (day of the month)

dddd, ddd, dd, d

Friday, Fri, Fr, 5 (day of the week, 0 = Sunday)

HH, H, hh, h

10, 10, 10, 10 (24-hour and 12-hour)

mm, m, ss, s, SSS

30, 30, 00, 0, 000

A, a

AM, am

ZZ, Z

+0000, +00:00

length

Number of characters.

{{summary.length}}

21

isEmpty

True if empty or only spaces.

{{summary.isEmpty}}

false

contains(text)

True if it contains the text.

{{summary.contains("Safari")}}

true

startsWith(text)

True if it starts with the text.

{{summary.startsWith("Login")}}

true

endsWith(text)

True if it ends with the text.

{{summary.endsWith("Chrome")}}

false

toUpperCase

Convert to uppercase.

{{summary.toUpperCase}}

LOGIN FAILS ON SAFARI

toLowerCase

Convert to lowercase.

{{summary.toLowerCase}}

login fails on safari

trim

Remove spaces at the start and end.

{{summary.trim}}

Login fails on Safari

urlEncode

Encode for use in a URL.

{{summary.urlEncode}}

Login%20fails%20on%20Safari

concat(text)

Add text to the end.

{{summary.concat(" [synced]")}}

Login fails on Safari [synced]

substring(start, end)

Characters from position start (counting from 0) up to, not including, end. Without end, to the end of the text.

{{summary.substring(0, 5)}}

Login

left(n)

First n characters.

{{summary.left(5)}}

Login

right(n)

Last n characters.

{{summary.right(6)}}

Safari

replaceAll(find, replace)

Replace every match. The text to find is literal, not a regular expression.

{{summary.replaceAll("Safari", "Chrome")}}

Login fails on Chrome

abbreviate(n)

Shorten to n characters and add … when something was cut.

{{summary.abbreviate(10)}}

Login fail…

split(separator)

Split into a list (default separator: a space). Add list functions after it.

{{summary.split(" ").first}}

Login

first

First item.

{{labels.first}}

backend

last

Last item.

{{labels.last}}

urgent

get(n)

Item at a position, counting from 0.

{{labels.get(1)}}

urgent

size

Number of items.

{{labels.size}}

2

distinct

Remove duplicates.

{{summary.split(" ").distinct}}

Each word once

join(separator)

Join into text. Default separator: comma and space.

{{labels.join(" | ")}}

backend | urgent

sum

Sum of the numbers in the list. Items that aren't numbers are ignored.

{{customfield_10060.split(",").sum}}

6

average

Average of the numbers in the list. 0 when there are no numbers.

{{customfield_10060.split(",").average}}

2

max

Largest item. Compares as numbers when all items are numbers, otherwise as text, which also works for dates.

{{customfield_10060.split(",").max}}

3

min

Smallest item, compared the same way as max.

{{customfield_10060.split(",").min}}

1

prettyDuration

Seconds as a Jira duration (8-hour days, 5-day weeks). 0m for zero or less.

{{timetracking.originalEstimateSeconds.prettyDuration}} with 388800 seconds

2w, 3d, 4h

abs

Absolute value.

{{now.diff(duedate).days.abs}}

Days between now and the due date, without sign

round

Round to a whole number.

{{customfield_10016.round}} with 2.6

3

Prefix the summary with the source key

Summary

[{{key}}] {{summary}}

Set a due date one week from now

Due date

{{now.plusDays(7).jiraDate}}

Copy the assignee as a user

Assignee

{{assignee.accountId}}

Keep the reporter's name in a text field

Short text custom field

Reported by {{reporter.displayName}} on {{created.longDate}}

Add a note to the description

Description

{{description}}, a new line, then Synced from {{key}}. The description is written as plain text.

Copy component names as one label

Labels

{{components.name.join("_")}}

Shorten a long summary

Summary

{{summary.abbreviate(100)}}

Write the priority as text

Short text custom field

{{priority.name}}

Header for synced comments

Comment template

{{comment.author.displayName}} wrote on {{comment.created.jiraDate}}: {{comment.body}}