We have a new documentation site. Please go here to see the latest.

Adding Templates to Issues

When a template is applied to an issue a separate copy of the template is added to the issue (as opposed to being linked to or referenced by the issue). If a template is later deleted from the templates list, copies of template that have been added to issues will remain.

Adding Templates to Issues Manually

To manually add a template to an issue:

  1. Click on the menu for the Checklist.

  2. Select Load templates.

  3. Use the checkboxes to indicate the template(s) you want to add to the issue. If there are more than ten templates in the project there will be a search bar you can use to find the desired template.

  4. Click Load template(s). The selected templates will be added to the issue.

  5. If the issue already has a checklist, you will be asked whether you want to append or overwrite the existing checklist. If you select Append, the template's items will be added to the end of the existing checklist. If you select Overwrite, all preexisting checklist items will be deleted prior to applying the template.

 

Adding Templates Automatically (Default Templates)

Adding Templates Based on an Issue Label

In Issue Checklist Pro, you can automatically add templates based on a value in the Jira labels field. To add a template based on a label.

  1. Ensure that the Apply checklist templates from issue labels global setting is enabled.

  2. Ensure that the template name does not include any spaces.

  3. Add a label (when creating or editing the issue) that exactly matches the name of the template (case sensitive).

  4. The template will be added to the issue. Note that removing the label will not remove the template once it has been applied.

     

If you remove and add a label (having a corresponding template) multiple times, checklist template will be applied every time you add the label, thus checklist items can get duplicated.

 

Bulk Adding Templates

To apply a template in bulk:

  1. Ensure that the Apply checklist templates from issue labels global setting is enabled.

  2. Use JQL to select the issues you want to add the template to.

     

  3. Click on the … menu and select Bulk change all x issues.

     

  4. Use the checkboxes to select the issues you want to add the template to. Click Next.

     

  5. Select Edit issues and click Next.

     

  6. Select Labels as the field to be edited.

  7. Use the dropdown to indicated if you want to add the label to existing labels, or replace the existing values. Note that removing a label from an issue will not remove corresponding checklist templates.

  8. Select the label that corresponds with the indicated template and click Next.

  9. Click Confirm.

  10. Click Done when the update is complete.