Your first approval

Five minutes, one page, nothing to configure. Do this on a real page you actually want reviewed, because there is nothing here you will need to undo afterwards.


1
Ask someone
2
Watch it
3
Answer one
4
Show it off

Open a page, click Approval under the title, add a colleague, and click Request approvals. That is the whole thing. They get an email straight away, and a Slack message if your site is connected. Every other option can wait for Request an approval.

Approval panel open under a page title, with three reviewers ticked under Pending and the request button at the bottom
Add your reviewers in the panel under the page title, then send the request with the blue button.

✓
Ask someone
2
Watch it
3
Answer one
4
Show it off

Open Capable, Approval. Your request is under Requested by you, showing who you asked and who has answered.

This is the screen that replaces chasing people in corridors. Leave it open for a day and you will see the point of it. More in Track approvals.

Approval dashboard with the new request listed under Requested by you, next to the reviewers who were asked
Your new request sits under Requested by you, with the reviewers you asked shown alongside it.

✓
Ask someone
✓
Watch it
3
Answer one
4
Show it off

Ask your colleague to send one back to you. It lands in your inbox, and you can approve it by dragging the card into the Approved column, or by opening the page and using the panel.

While you are there, try leaving a comment instead of approving, and watch what happens to the status.

You click

The request becomes

Why

Approve

APPROVED

Your yes met the threshold.

Comment

IN REVIEW

Comments are recorded, but never count as a yes.

Approval inbox board with Waiting for you, Approved and Rejected columns, and one request waiting for an answer
Drag a card from Waiting for you into Approved to give your answer.

✓
Ask someone
✓
Watch it
✓
Answer one
4
Show it off

Edit the page, type /approval, and insert the macro in Banner mode. Now anyone reading the page can see it was approved without knowing where to look for the byline. See The approval macro.

Typing the approval command in the editor brings up the Approval Capable macro as the first suggestion
Type /approval while editing and pick Approval (Capable).
Approval macro in Banner mode in the editor, showing a purple Page is pending approval banner
In Banner mode the macro shows the approval status as a coloured strip, so readers see it at a glance.

#What to set up next

If you want

Go to

To stop picking the same reviewers every time

Teams and assignment

Pages to come back for review every six months

Expiry and re-approval

Every new page in a space to need approval

Automatic approvals

Approvals to count as signatures

Sign approvals with a code

Approved pages published automatically

Publishing


#A few things that catch people out

  • Editing the page after you send restarts the review on the new version.

  • Sending with nobody selected does nothing at all, and says nothing either.

  • People who cannot read the page are skipped silently, so check access if someone says they heard nothing.

  • Approving does not publish the page unless somebody switched that on. See Space settings.



That is your first approval done, start to finish. Everything after this is just making it faster.