Overview
Variables are placeholders for field values that are fetched from the system when the issue is created. Variables are used to store information that is not known at the time the issue is created, such as the current user's name or the current date and time.
Variables can be used in default values configuration. See more here.
Currently, variables are supported for the following fields:
Summary
Text field (single-line)
Description
Environment
Paragraph (multi-line text).
System variables
Jira system variables are predefined placeholders designed to encapsulate dynamic information throughout the instance. They are available across all templates and are generated automatically at the moment of issue creation.
Use case
Let’s take a look at a template with variables used by an HR team to automate team members data entry and improve workflow efficiency.
The template contains a description field with three system variables: $TODAY, $CURRENT_USER_NAME and $PROJECT_LEAD_NAME.
When the template is used and a ‘Create issue’ dialogue is prompted, the correct values automatically replace the variable's placeholders.
Configuration
System variables are configured through the ‘Default values’ tab in the template configuration.
To insert a variable into an issue field, enter '/' into one of the supported fields. Start typing to find the required variables faster.
List of supported system variables
Variable | Description | Value Example | Context |
---|---|---|---|
$CURRENT_USER_ACCOUNT_ID | Account ID of the currently logged in user | 562658:342fc226-3c34 |
|
$CURRENT_USER_NAME | Name of the currently logged in user | Tom West |
|
$PROJECT_KEY | Key of the project | DEV |
|
$PROJECT_NAME | Name of the project | Development |
|
$PROJECT_LEAD_NAME | Name of the project lead | Tom West |
|
$PROJECT_LEAD_ACCOUNT_ID | Account ID of the lead of the project | 562658:342fc226-3c34 |
|
$TODAY | Current date | 16.09.22 |
|
$CURRENT_TIME | Current Time | 01:16 |
|
$TOMORROW | Tomorrow | 17.09.22 |
|
$NEXT_WEEK | Next week (current day + 7 days) | Today: Next week: |
|
$WEEK_OF_YEAR | Current week’s number | 37 |
|
$PARENT_KEY | Key of the parent issue | subtask templates only | |
$PARENT_SUMMARY | Summary of the parent issue | New feature request | subtask templates only |
$PARENT_ISSUETYPE | Issue type of the parent issue | Task | subtask templates only |
$PARENT_STATUS | Status of the parent issue | Done | subtask templates only |
$PARENT_PRIORITY | Priority of the parent issue | Medium | subtask templates only |
$PARENT_DUE_DATE | Due date of the parent issue | 2020-01-31 | subtask templates only |
$PARENT_CUSTOMFIELD | Value of any custom field of the parent issue. Pattern to use it : $PARENT_CUSTOMFIELD_ID | any value | subtask templates only |