The approval workflow is a review queue that sits between authoring and going live. When a team member publishes a question, template, or feedback form, or submits an offer for sending, the item enters a Pending state and waits for a second person to approve it. This prevents unreviewed content from reaching interviewers or candidates — and ensures an offer is approved before it is sent to a candidate.
Prerequisites
Request states
A request moves through the following states:
| State | Meaning |
|---|---|
| Pending approval | Submitted and waiting for a reviewer |
| Approved | Reviewer approved; the item went live |
| Rejected | Reviewer rejected with a written reason |
| Withdrawn | Submitter cancelled the request before review |
Submitting a request
Publishing any question, template, or feedback form creates an approval request automatically.
- Open the item you want to publish.
- Select Publish.
- If you hold the matching approve permission, the item goes live immediately — no separate review step is needed.
- If you do not hold the approve permission, the item shows a Pending approval badge and waits in the review queue.
Reviewing a request (approvers)
Reviewers see outstanding requests in the Your approvals widget on the dashboard, and inline on the question, template, or feedback form list.
Approve
- Open the request — either from the Your approvals dashboard widget or inline on the item.
- Select Approve.
- The item goes live immediately.
Reject
- Open the request.
- Select Reject.
- Enter a reason in the Rejection reason (required) field.
- Select Confirm reject.
The submitter sees a Rejected badge on the item and can read the reason before deciding whether to resubmit.
Resubmitting after rejection
If a request is rejected, the original submitter can update the item and resubmit it.
- Open the rejected item.
- Make the necessary changes.
- Select the Resubmit button (the rotate icon next to the item).
- The request returns to Pending approval with the updated content. The previous rejection reason is cleared.
Only the original submitter can resubmit. Other team members cannot resubmit on their behalf.
Withdrawing a pending request
If a request is still pending, the original submitter can cancel it.
- Open the item with the Pending approval badge.
- Select the Withdraw request button (the X icon).
- The request moves to Withdrawn.
A withdrawn request cannot be re-opened. To publish the item again, select Publish to create a new request.
Dashboard widget
The Your approvals widget on the home screen lists all pending requests that are assigned to you for review — requests you submitted yourself are excluded. Each row shows the item title, type, submitter name, and when it was submitted. Select Review to open the review dialog.
Permissions reference
| Action | Permission | Default roles |
|---|---|---|
| Submit question for publication | questions:publish | AdminStaffing |
| Submit template for publication | templates:publish | AdminStaffing |
| Submit feedback form for publication | feedback_forms:update | AdminStaffing |
| Approve / reject questions | questions:approve | AdminStaffing |
| Approve / reject templates | templates:approve | AdminStaffing |
| Approve / reject feedback forms | feedback_forms:approve | AdminStaffing |
| Approve offers | offers:approve | no default role |
Troubleshooting
"A pending approval request already exists" — The item already has an open request. Ask the reviewer to act on it, or withdraw it yourself before resubmitting.
"Cannot review your own request" — You submitted this request. A different team member with the approve permission must review it.
"Request is not pending" — The request was already approved, rejected, or withdrawn. No further review action is possible on it.
Resubmit button not visible after rejection — Only the original submitter sees the resubmit option. Log in with the account that submitted the original request.