Apps documentation
Issue Templates for Jira
Cloud Server/Data Center
Issue Templates for Jira

Cloud

Server/Data Center

Version 8.x
Version 7.x
FAQ
Release notes
Articles & Videos
Last updated Jun 28, 2020

New variables - Version 7.13 and above

Learn how to migrate variables created in older Issue Templates versions

The new version of Issue Templates (7.13) brings a new, better variables format. One of the improvements is the change of names:

Static variables became System variables: the ones that are ready to use and available in the entire system.

Dynamic variables are now called User variables: since users themselves can create and define specific variables that meet their needs.

Variables migration

After installing the new Issue Templates version, you’ll be able to convert your existing variables into the new format. The app will find all templates containing old variables for you. We strongly recommend migrating all variables that are already in use. The conversion will not delete old variables - they’ll remain available in the templates you’ve already created.

We’d like to encourage you to migrate all variables anyway, as the new format is much simpler and will be commonly used soon.

There are two ways to migrate variables. You can either select one particular template and migrate the variables that are used there, or migrate all variables in all templates at once.

Migrate variables in one template

Steps

To start the migration for one particular template:

  1. Open a template issue from your template repository (TEMP).
  2. Click Start conversion in the right-hand side panel.
  3. A dialog box will show up with all your old variables checked. If you wish to exclude some variables from the conversion, just uncheck them.
  4. Click Convert to migrate all selected variables.
Jira Issue Templates - Variables
Issue Templates for Jira - Variables

Result

Selected variables got migrated to the new format.

Warning
  • When migrating only one issue, the conversion won’t affect the whole structure, provided the variables you’ve used are of a different type than text. For example, if a select field was set up as a variable in a task and its subtask, then the variable will only be migrated in the main task, meaning you’ll need to update it in the subtask manually.
  • This doesn’t affect text-based variables, as they get migrated automatically.

Migrate variables in all templates

Steps

To start the migration for all templates:

  1. Go to Manage apps and select Convert Variables from the left-hand side menu.
  2. Click Convert all.
Jira Issue Templates - Variables
Issue Templates for Jira - Variables
Warning
In some cases it might be necessary to manually adjust unique variables in existing templates that are more complex.

Result

After the migration, a new panel will be added to the right-hand side of your template issues. All migrated variables will be visible under Added to template.

Jira Issue Templates - Variables
Issue Templates for Jira - Variables
Need help?

If you can’t find the answer you need in our documentation, raise a support request.