This chapter provides information about three types of fields supported by dynamic variables.
There are multiple types of fields supported by dynamic variables. Using correct formatting, you can define:
Add * at the end of the placeholder to make a field required.
Add * inside the brackets to allow selecting more than one option (multi-select instead of single-select).
Use the | mark as a separator to create Select options. For example: [City|Warsaw|London|Berlin].
Following examples assume you are using brackets [] as a start and an end pattern of your placeholders and * as a required mark. You can change them, see Dynamic Variables Format for details.
| Placeholder | Field type | Field name | Field options | Required |
|---|---|---|---|---|
| [Version] | Text field | Version | - | false |
| [Version required]* | Text field | Version Required | - | true |
| [City|Warsaw|London|Berlin] | Single select | City | Warsaw, London, Berlin | false |
| [City Required|Warsaw|London|Berlin]* | Single select | City Required | Warsaw, London, Berlin | true |
| [City Multi-select*|Warsaw|London|Berlin] | Multi select | City Multi-select | Warsaw, London, Berlin | false |
| [City Multi-select Required*|Warsaw|London|Berlin]* | Multi select | City Multi-select Required | Warsaw, London, Berlin | true |
| [Version]* | Text field | Version | - | true |
| [Definition of Done:paragraph] | Text field (multi line) | Definition of Done | - | false |
| [Launch date:date] | Date picker | Launch date | - | false |
| [Meeting time:datetime] | Date time picker | Meeting time | - | false |
| [Manager:user] | User picker | Manager | Returns a list of users whose attributes match the query term | false |
| [Story points:number] | Number field | Story points | - | false |
You can also use the following variables:
| Field | Value |
|---|---|
| DATE | date |
| DATE_TIME | datetime |
| MULTISELECT | multiselect |
| PARAGRAPH | paragraph |
| SELECT | select |
| STRING | string |
| USER | user |
| USERS | users |
| ISSUE | issue |
| SPRINT | sprint |
For user picker you need browse users permission to search by user attributes, such as displayName and emailAddress. Otherwise, you need to type an exact username.
See Atlassian developer website for more details.
