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

JQL searchers

Check out JQL functions available for Issue Templates.

Issue Templates for Jira provides three JQL functions described below. They can be used in any place in Jira where using JQL is available: in the Issue Navigator, in a Saved Filter, as an Agile Board query, etc.

createdFromTemplate

createdFromTemplate JQL function lets you search issues created from a particular template.

To specify a searching condition in JQL, use the following format:

issue in createdFromTemplate("template_issueKey")

Function argument Description
template_issueKey The issue key of template.

Example:

To find issues created from the template TEMP-15: createdFromTemplate("TEMP-15")

Note

You can also check which issues are created from template by clicking on the number next to Used in in Issue Templates section in concrete template. Page with JQL search opens.

searchTemplates

searchTemplates JQL function lets you search for templates that follow defined conditions.

To specify a searching condition in JQL, use the following format:

issue in searchTemplates("argument", "value")

Function argument Value Description
category
templateName
Values specified for the argument. The configuration defined in the General tab.
autocompleteScopeName
autocompleteScopeField
autocompleteScopeId
copyScopeName
copyScopeField
copyScopeId
Values specified for the argument. The configuration defined in the Set of fields tab.
enabled
disabled
True / Yes /1 or False / No / 0. The configuration defined in the Availability tab.
projectAvailability
projectCategoryAvailability
issueTypeAvailability
screenAvailability
groupAvailability
userAvailability
languageAvailability
Values specified for the argument. The configuration defined in the Availability tab.

Examples:

  • To find templates which fall under the Human Resources category:
    searchTemplates("category","Human Resources")
  • To find templates which use a scope named Onboarding for the Autocomplete function:
    searchTemplates("autocompleteScopeName","Onboarding")
  • To find templates which use a scope containing Priority field for the Copy function:
    searchTemplates("copyScopeField","priority")
  • To find templates which are enabled:
    searchTemplates("enabled","true") or searchTemplates("enabled","yes") or searchTemplates("enabled","1") or searchTemplates("disabled","false") or searchTemplates("disabled","no") or searchTemplates("disabled","0")
  • To find templates available for project Developers (DEV):
    searchTemplates("projectAvailability","DEV")
    Warning

    To use searchTemplates for the projectAvailability, the value must be equal to the project key. This JQL doesn’t support a project name.

  • To find templates available for the Bug issue type:
    searchTemplates("issueTypeAvailability","Bug")
  • To find templates available for Spanish-speaking users:
    searchTemplates("languageAvailability","Spanish") or searchTemplates("languageAvailability","ES")
Note

To use autocompleteScopeId and copyScopeId, you have to provide a scope ID. You can find it in the ID column in the following database table: AO_33A75D_IT_PROFILE.

templateForIssue

templateForIssue JQL function lets you search for a template which has been used to create a particular issue.

To specify a searching condition in JQL, use the following format:

issue in templateForIssue("issueKey")

Function argument Description
issueKey The issue key of issue created from the template.

Example:

To find the template used to create the DEV-372 issue, use: templateForIssue("DEV-372")

Warning

This JQL function doesn’t support sub-tasks created from template using Issue Templates versions that are older than version 7.4.0, because we didn’t collect the specified data. Search results can be empty.

Info

For more information about JQL searching, see official Atlassian documentation on Advanced Searching and Advanced Searching Functions.

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.