The following tokens can be used as part of texts in config screen.

Issue Fields

TokenReturn TypeDescriptionSample ValueCan be followed by other tokens?
{issue}Issue

References the current issue.

If used by itself, returns the key of the issue.

ABC-123Y
{issue.affectsversion}Text

Affected Version(s) field on the issue.

Values are separated by comma if there are more than one.

v1, v2, v3

{issue.assignee}

User

References the Assignee field of the current issue.

If used by itself, returns the username of the assignee.

john.doeY

{issue.components}

TextComponents field of the current issueComponent 1, Component 2

{issue.created}

{issue.createddate}

TextCreated Date of the issue.

2019-08-27 14:58


{issue.creator}User

Creator field of the issue.

If used by itself, returns the username of the assignee.

john.doeY
{issue.description}TextDescription field of the issueSome sample description text

{issue.due}

{issue.duedate}

TextDue Date field of the issue2019-08-27
{issue.environment}TextEnvironment field of the issueSome sample environment text
{issue.fixversion}TextFix Version(s) field of the issuev1, v2, v3

{issue.issuetype}

{issue.type}

TextIssueType of the issueTask
{issue.key}TextIssue Key of the issueABC-123
{issue.labels}TextLabel(s) field of the issueLabel 1, Label 2, Label 3
{issue.parent}Issue

Parent issue of the issue.

If used by itself, returns the key of the parent.

If there is no parent (the current issue is not a subtask) returns empty.

ABC-122Y
{issue.parentkey}Text

Key field of parent issue.

If there is no parent (the current issue is not a subtask) returns empty.

ABC-122
{issue.priority}TextPriority field of the issueHigh
{issue.project}Project

Project that the issue belongs to.

If used by itself, return the project key.

ABCY
{issue.projectkey}TextKey of the project that the current issue belongs to.

{issue.reporter}User

Reporter field of the issue

If used by itself, returns the username of reporter.

jane.doeY
{issue.resolution}TextResolution field of the issue.Done

{issue.resolutiondate}

{issue.resolved}

TextResolution Date of the issue2019-08-27 14:58
{issue.status}TextStatus of the issueIn Progress
{issue.summary}TextSummary of the issueMy sample issue

{issue.updated}

{issue.updateddate}

TextUpdated Date field of the issue2019-08-27 14:58

{issue.<cf_12345>}

(non JQL Issue Select custom field)

Text

The custom field with ID 12345 of the issue.

The field ID can be any field defined in the system.

Some custom field value

{issue.<cf_98765>}

(JQL Issue Select custom field)

Issue(s)

The issue(s) selected in JQL Issue Select field with ID 98765.

98765 can be the field ID of any JQL Issue Select field defined in the system (JQL Advanced Field or one of the deprecated fields). 

If used by itself, return the keys of the selected issue or issues.

Please see JIS v2.0 - Using JIS Fields in Token Strings for the advanced uses of JQL Issue Select custom field tokens.

ABC-156, ABC-157Y

{issue.<cf_34567>

(Single or Multi User Picker custom field)

User

The users(s) selected in JQL Issue Select field with ID 34567.

If used by itself, return the usernames of the selected users.

john.doe, jane.doeY

{issue.<cf_23456>}

{Date custom field}

Text

The custom field of type Date with ID 23456.

The field ID can be any field defined in the system.

2019-08-27

{issue.<cf_45678>}

{DateTime custom field}

Text

The custom field of type DateTime with ID 45678.

The field ID can be any field defined in the system.

2019-08-27 14:58

{issue} token and any token string that starts with {issue.} do not work on create screens because the issue is not created yet.

You can use {parent}, {project} or {currentuser} tokens and their fields on create screens.


Parent Fields

{parent} token references the parent issue. It can be followed by all the issue field tokens listed in "Issue Fields" section.

{parent} token works pretty much the same as {issue.parent} but can also be used on Create screen. {issue} token does not work on create screens because the issue is not created yet.


TokenReturn TypeDescriptionSample ValueCan be followed by other tokens?
{parent}IssueReturns the parent issue of the current issue (if any)ABC-122Y

Project Fields

{project} token references the current project. 

{project} token works pretty much the same as {issue.project} but can also be used on Create screen. {issue} token does not work on create screens because the issue is not created yet.


TokenReturn TypeDescriptionSample ValueCan be followed by other tokens?

{project}

ProjectReturns the current project.ABCY
{project.key}TextReturns the key of the current projectABC
{project.id}TextReturns the ID of the current project10123
{project.name}TextReturns the name of the current projectMy sample project
{project.lead}User

Returns the Project Lead user of the current project.

If used by itself, return the username of the project lead user.

john.doeY
{project.components}TextReturns all the components defined in the current projectComponent 1, Component 2, Component 3
{project.versions}TextReturns all the versions defined in the current projectv1, v2, v3

User Fields

Any user object (that is returned by a system or a custom field token) can be followed by the tokens below. 

The samples below reference {issue.assignee} but can be replaced by any token string that returns a user.

TokenReturn TypeDescriptionSample ValueCan be followed by other tokens?
{issue.assignee}User

Returns the user that is the assignee of the issue.

If used by itself, return the username of the assignee.

john.doeY

{issue.assignee.name}

{issue.assignee.username}

TextReturns the username of the assignee of the issue.john.doe
{issue.assignee.displayname}TextReturns the Display Name of the assignee of the issue.John Doe
{issue.assignee.email}TextReturns the e-mail of the assignee of the issue.john.doe@gmail.com
{issue.assignee.<property_name>}Text

Returns the property value of the user that is defined by property_name. 

Returns empty if a property with property_name is not found.

Some property value


Current User

{currentuser} is a token that returns the current logged in user. It can be followed by all the user field tokens listed in "User Fields" section.


TokenReturn TypeDescriptionSample ValueCan be followed by other tokens?
{currentuser}UserReturns the currently logged in userjohn.doeY



  • No labels