With the OneApproval Confluence app, you can request, review and manage approvals from the byline of any page, without leaving Confluence.
Your Confluence admin needs to have installed the app and connected your site to a OneApproval organisation. See Install the Confluence app.
Open OneApproval on a page
-
Open the Confluence page you want to work with.
-
Select OneApproval in the page byline, under the page title.
The OneApproval panel opens. From here you can always:
-
Request approval, or see the current approval if there is one
-
Select View page history to see the approval history for the page
-
Select Dashboard to open the OneApproval web app
Request approval
-
In the OneApproval panel, select Quick approval.
-
The current page is already selected as the document.
-
Optionally, enter a Title for the request.
-
Optionally, add Additional information for your approvers, such as what to focus on.
-
Choose your approvers:
-
Registered approvers: Search for people in your OneApproval organisation. You can include yourself.
-
Invite by email: Enter the email address of anyone else. They'll be invited to your organisation and asked to review.
-
-
Select Submit approval request.
The approval is created in the organisation your site is connected to, approvers are notified by email, and the page status in the byline changes to Pending . Every approver needs to approve. To set a lower minimum, request the approval from the web app instead.
Approvers need permission to view the Confluence page. OneApproval doesn't change Confluence page permissions.
Review a page
If you're an approver, you'll see the decision options when you open OneApproval on the page.
-
Open the page and select OneApproval in the byline.
-
Review the page.
-
Optionally, add a comment.
-
Choose Approve, Approve with changes, Request changes or Reject.
The panel shows your decision alongside the overall status. You can change your decision at any time while the approval is still in progress. See How approvals work for how decisions affect the overall status.
Track progress
The page's approval status shows in the byline, so anyone viewing the page can see where it's up to. Open OneApproval and select View full detail to open the approval in the web app, including every approver's decision.
Resubmit a request
As the requester, you can resubmit at any stage, including while the approval is still in progress. Once an approval is concluded, anyone can resubmit it. Most often you'll do this after updating the page in response to requested changes.
-
Open OneApproval in the byline and select Resubmit.
-
Optionally, change the approvers.
-
Confirm.
All decisions are reset and the status goes back to Pending .
Cancel a request
As the requester, you can cancel a request.
-
Open OneApproval in the byline and select Cancel request.
-
Confirm.
The approval is removed from the page, which goes back to having no current approval.
View and export the page's approval history
-
Open OneApproval in the byline and select View page history.
-
Review the timeline of requests, decisions, resubmissions and status changes, with timestamps and the Confluence page version.
-
Select Export to download the history as a CSV file.
Limitations in early access
-
Quick approval only: one round, no templates.
-
Approvers must be OneApproval organisation members or invited by email. Picking Confluence users directly is planned for after launch.
-
Editing the page after it's approved doesn't change the approval. Expire on edit is coming at launch.