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 |
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.