This function returns the issue list of issues returned by the specified JQL query. Visibility restrictions (permissions and issue security) might apply. By default this query will be run as the current user.


We suggest using this function for performance reasons when the number of issues to be retrieved or filtered is very high (e.g. all issues in a project or in status) instead of functions like:


issuesFromJQL(jqlQuery) #Output: Issue list



Parser expressionDescription


issuesFromJQL("status in (Open, Done)")


This example returns an issue list with all issues that are in status "Open" or "Done".


issuesFromJQL("'Story points' is not empty")


This example returns an issue list with all issues that do have Story points.



Parameters used in this function

ParameterInput (data type)Description
jqlQuery

Any valid JQL Query.

 Double quotation marks in JQL have to be replaced with single quotation marks, e.g.:


Usually JQL would look like"Epic Link" is not empty
Using it within issuesFromJQL()'Epic Link' is not empty




This function returns an .

If the JQL query  does not return a result, the function returns an empty .




Variant where you additionally can specify a user which will execute the JQL query.


issuesFromJQL(jqlQuery, userName) #Output: Issue list



Parser expressionDescription


issuesFromJQL("status in (Open, Done)",%{issue.reporter))


This example returns an issue list with all issues that are in status "Open" or "Done" that are visible for the reporter of the given issue.



Parameters used in this function

ParameterInput (data type)Description
jqlQuery

Any valid JQL Query.

 Double quotation marks in JQL have to be replaced with single quotation marks, e.g.:


Usually JQL would look like"Epic Link" is not empty
Using it within issuesFromJQL()'Epic Link' is not empty


userName

Text containing a valid user name.



This function returns an

If the JQL query does not return a result, the function returns an empty



Use cases and examples



Parser function cloudissuesFromJQL()
Map(tick)
Notes






Status
Tech review

Style guide




Short description

Returns a list of issues returned by a specified JQL query.

Output

Available since

Label