Using Section Approvals | Approvals for Confluence

Add approvals to specific sections of a page, so that different people or teams can approve different parts of the same document.

Add a Section Approval to a Page

Edit the page and put your cursor where you want the section approval to go.
Type /section approval and select the Section Approval macro.
The approval settings open. Choose your settings (see the table below).
Select Confirm. The section approval is now live on the page.

Approval settings

Setting	What it does
Approvers	Search for users, Confluence groups and Approval teams.
Expire on Edit	If someone edits the page after it’s approved, the approval expires and goes back to Pending. On live docs this can take up to 15 minutes after the edit session ends.
Expire on Date	Set Date & Time: the approval expires on a fixed date and time. Set Time Interval: the approval expires a set time after the page is approved, for example 2 weeks. The countdown starts only when the page is approved. Turn on Auto Reapply Interval to restart the countdown every time the page is approved again.
Set Minimum Required Approvals	How many approvals the page needs before it moves to approved status.
Reset	Puts every setting back to the defaults that were set in space settings.

Track the approval

You can see the approval status on the macro. The number shows how many approvers have approved so far, out of the total. The status can be Pending, Approved, Rejected or Expired.

The macro shows:

the approval name and its status
a progress bar of approvals received against approvals required, for example 0 of 2 approvals required
the approvers
a View detail link to the full approval record
The ••• menu

Check when the approval expires

If the approval has an expiry date, it appears on the macro.

Approve or reject a section

If you’re an approver, the approval macro shows Approve and Reject buttons.

Select Approve or Reject.
Add a comment if you want to. Comments are optional.
Select Approve or Reject again to confirm.

View approval details

Select View detail on the approval card to see the full approval record. It shows:

the approval description
the overall status, the number of approvers and the number of approvals required
who requested the approval, and when
the expiration date, if there is one
each approver’s decision and comment, with the date and time they acted

Select Close to go back to the page.

To edit the approval

Edit the page.
Select the edit button (pencil) on the section approval macro.

Need support? We’re here to help 🧡

If you have any questions or would like to speak with us about Approvals for Confluence, please reach out to our Customer Support team.

Looking to get started quickly with approvals?

You can begin your 30-day free trial of Approvals for Confluence on the Atlassian Marketplace here.