Structure (Cloud)
Breadcrumbs

Predefined Variables

As you write your formula, Structure attempts to map your variables to well-known Jira fields:

  • Variables with the same name as a field are mapped to those fields. For multi-word fields, you can write the words without spaces, or place a _ between each word: affectsVersions or affects_Versions

  • Many commonly used variations of field names are mapped to the corresponding field.

  • In addition to Jira fields, some variable names are automatically mapped to common Structure attributes. See Structure Attributes .

When naming variables:

  • Do not include spaces. Omit spaces or use an underscore.

  • Case is ignored (AffectsVersions is the same as affectsversions)

Jira Fields

The following list contains the most commonly used variables that are automatically linked to a Jira field. This is not a complete list.

Jira Field

Standard Variable Name

Type

Notes

Affects Version/s

affectsVersions

Array< Version >


Assignee

assignee

User


Components

components

Array< Component >


Created

created

Number (Date/Time)


Creator

creator

User


Description

description

Text


Due Date

dueDate

Number (Date)


Environment

environment

Text


Epic

epic

Text

Works for company-managed and team-managed projects

Epic Link

epicLink

Text

Only works in company-managed projects

Fix Version/s

fixVersions

Array< Version >

Can also use: versions

Key

key

Text

Can also use: issueKey

Issue ID

issueid

Number


Issue Type

issueType

Issue Type


Labels

labels

Array<String>


Last Comment

lastComment

Last Comment


Original Estimate

originalEstimate

Number (Duration)


Priority

priority

Text


Project

project

Project


Remaining Estimate

remainingEstimate

Number (Duration)


Reporter

reporter

User


Resolution

resolution

Text


Resolved

resolved

Number (Date/Time)

Can also use: resolutionDate

Sprint

sprint

Sprint


Status

status

Status


Status Category

statusCategory

Text


Summary

summary

Text


Time Spent

timeSpent

Number (Duration)


Updated

updated

Number (Date/Time)


Work Logs (Jira)

jiraWorkLogs

Array< Work Logs (Jira) >


Work Logs (Tempo)

tempoWorkLogs

Array< Work Logs (Tempo) >


Structure Attributes

The following variables are automatically mapped to Structure attributes.

Variable Name

Type

Results

this

*

Returns the value of type "Item" representing the item for which the formula is calculated.

If the formula is calculated for a work item, it will be of type Issue.

If, for example, you group work items by Sprint, you will have rows in the structure representing sprints. For those rows, the "item" variable will return items of type Sprint.

itemid

Text

Returns the item type plus the item ID. Ex. "issue/10800"

itemType

Text

Returns the item type: issue, project, user, folder, etc.

level

Number (Integer)

Returns the level of the item within the structure's hierarchy. Can also use: depth

done

Number (Boolean)

Returns a '1' if the work item is Done; otherwise, '0'