Dynamic variables

This chapter provides information about dynamic variables.

Dynamic variables are placeholders which you can define in your primary template in text fields (for example summary, description). Right before an issue is created from a template, dynamic variables are collected from the primary template and an additional form is displayed. It’s the place where you provide values.

While placeholders are collected only in the primary template, they are replaced with provided values both in primary and secondary templates.

For example, you can configure a template like this:

One definition, many usages

It is sufficient to define a variable only once in any field. It can then be referenced only by a name. The order doesn’t matter.

Dynamic variables format

To configure the format of your dynamic placeholders:

1. Go to the Project settings in the template repository project and select Issue Templates.
2. Click Variables tab.
3. Select Dynamic type of a variable from the drop-down list.
4. Settings of variables displays:
   a. Start pattern: Type pattern which opens a variable.
   b. End pattern: Type pattern which closes a variable.
   c. Mandatory mark: Type mark which a user should add after the end pattern to make the variable required.
   d. Replace empty option: When switched on, if a variable is optional, and the value is not provided, replace the variable placeholder with an empty string (for example: text: “City {{ cityVariable }} is optional” becomes “City is optional“)

Dynamic variables in Automation

Dynamic variables are supported while creating issues via issue.templates.automation property.