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

Server/Data Center

Cloud

8.x
7.x
FAQ
Release notes
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. We’ve upgraded the way of creating and using variables to make it simple, fast and easy.

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

This subsection describes the migration of variables created in older Issue Templates versions (Version 7.12.0 and below)

After installing the new Issue Templates version, you’ll be able to convert your existing variables into the new format. Our 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 Window will show up with all your old variables checked. If you wish to exclude any of them from the conversion, just uncheck the blue box.
  4. Click Convert to migrate all selected variables.
Issue Templates for Jira - Variables
Issue Templates for Jira - Variables
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 sub-task, then the variable will only be migrated in the main task, meaning you’ll need to update it in the sub-task 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-side menu
  2. Click Convert all
Issue Templates for Jira - 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.

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.

Issue Templates for Jira - Variables
Issue Templates for Jira - Variables

Need help?

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

*Include as much information as possible to help our support team resolve your issue faster.