- Introduction
- About
- Approvals JQL functions
- Configuration
- Configuration Overview
- Approvals Settings
- Workflow Configuration
- Approvals Configuration
Last updated May 9, 2022
Approvals JQL functions
Overview of JQL functions that let you swiftly filter issues with Approvals
To aid navigation in issues to which Approvals are applied, the app provides a set of JQL functions that you can use to search for issues. For more information on JQL functions, see Atlassian documentation.
Functions with examples
| Function | Description | Arguments | Example |
|---|---|---|---|
| pendingApproval | Returns issues that are waiting for approval from the specified user. | username | issue in pendingApproval("admin") |
| pendingMyApproval | Returns issues that are waiting for approval from the currently logged in user. | Doesn’t take any value | issue in pendingMyApproval() |
| approvedByMe | Returns issues approved by the currently logged in user. | Doesn’t take any value | issue in approvedByMe() |
| rejectedByMe | Returns issues rejected by the currently logged in user. | Doesn’t take any value | issue in rejectedByMe() |
| approvedInStatus | Returns issues that have been approved while in the given status. | workflow status name | issue in approvedInStatus("Waiting for Approval") |
| rejectedInStatus | Returns issues that have been rejected while in the given status. | workflow status name | issue in rejectedInStatus("Waiting for approval") |
| pendingGroupApproval | Returns issues that are awaiting approval from members of the specified group. | name of a Jira group | issue in pendingGroupApproval("jira-software-users") |
| pendingRoleApproval | Returns issues that are waiting for approval from users with a given role | name of a Jira role | issue in pendingRoleApproval("Administrators") |
Note
It is not possible to use an empty string ("") in the pendingApproval function. It requires a username, for example issue in pendingApproval("admin").
Need help?
If you can’t find the answer you need in our documentation, raise a support request.
