Klob Approvals documentation
Approvals on Jira workflow transitions, for company-managed and team-managed projects.
Get started
- Install Klob Approvals from the Atlassian Marketplace (a Jira admin does this once).
- Open the workflow of a project and select the transition that needs approval, for example Done or Release.
- Add the validator Approval required (Klob Approvals) to that transition.
- Choose approvers: people, groups, or both. Set how many approvals the transition needs. Save, and publish the workflow.
How it works
- When someone tries the transition, Jira blocks it until enough approvers approve. The message says how many approvals are missing and who can still approve.
- The approvers get a Jira notification. They open the issue and use the Approvals panel to approve or reject.
- One rejection blocks the transition until that person changes their decision.
- Each person counts once, whether they are listed by name or as a member of a listed group.
- Anyone who can move the issue can start the approval from the panel with Request approval, before trying the transition.
- Approvals are good for one move. When the issue enters the target status, the approval moves to the panel's history, which keeps the last 20 per issue.
- If an admin changes the approvers or the number required, approvals collected under the old rule are moved to the history and a new approval starts.
Permissions
The panel only shows approvals to people who can browse the issue, and only people who can transition it can request approval. Klob Approvals asks Jira for these permissions on every action.
License
If the license is not active, transitions are no longer blocked and the panel says so. Klob Approvals never blocks your workflows because of a billing problem. Renew the license to enforce approvals again.
Uninstalling
Remove the validator from your workflows before you uninstall. A validator whose app is gone can block the transition for everyone until a Jira admin removes it.
Troubleshooting
| Message | What to do |
|---|---|
| Approval rule is not configured for this transition. Ask a Jira admin to edit the "Approval required" validator. | The validator has no approvers. A Jira admin edits the transition and adds at least one person or group. |
| Needs N more approvals (M required). Waiting for: names. | The transition is waiting for approvals. The approvers named in the message decide in the issue's Approvals panel. |
| Rejected by a name. The transition stays blocked until they approve. | Talk to the person who rejected. They can change their decision to Approve in the panel. |
| Could not read this issue to check its approvals. Try again. | Jira did not answer in time. Try the transition again; if it repeats, contact support. |
| Approvals could not be checked right now. Try again in a moment. | A temporary error. The transition stays blocked so nothing moves without approval. Try again in a moment. |
| The Klob Approvals license for this site is not active, so approvals are not enforced. Ask a site admin to renew it. | A site admin renews the license in Manage apps. |
| Open this panel from an issue to see its approvals. | Open the issue itself, not a board or a list. |
| This approval is no longer open. Reload the issue to see where it stands. | The issue moved or the approval closed. Reload the page. |
| You are not one of the approvers for this transition, so your decision was not saved. | Only listed people and members of listed groups can decide. Ask a Jira admin if you should be one. |
| That decision could not be saved. Choose Approve or Reject again. | Choose again. If it repeats, reload the issue. |
| The issue moved or its approval rule changed while you were deciding, so your decision was not saved. Check the panel and decide again. | Reload the issue and decide again on the current approval. |
| Jira says you do not have permission for this on this issue. | You need permission to browse the issue, and to transition it to request approval. Ask a Jira admin. |
| Klob Approvals could not finish that just now. Try again in a moment. | A temporary error. Try again; if it repeats, contact support. |
| Could not reach Klob Approvals. Check your connection and try again. | Check your network and reload the issue. |
| Search is not available right now. Try again. | In the validator settings, wait a moment and type again. |
| Add at least one approver or group. | The rule needs someone who can approve. |
| Ask for between 1 and N approvals. | Set a number of approvals within that range. |
| Could not load the configuration. Close this dialog and open it again. | Close the validator settings and open them again. |
| The configuration is still loading. Wait a moment and save again. | Wait until the approvers appear, then save. |
| (No message) Approvers do not get the "Approval needed" email. | Klob Approvals sends Jira's own notification, so Jira needs outgoing email turned on: a Jira admin checks Settings > System > Outgoing mail. Approvals still work without it: approvers find pending approvals in the issue's Approvals panel. |
Support
See Support. Include the message Klob Approvals shows and the issue key.