Approval reviewer settings

Overview

In the app space settings, you can configure how reviewers are assigned and the users who can be assigned as reviewers using the workflow builder visual editor.

Open

Reviewer settings

Configure the approval assignment of Reviewers in the workflow builder visual editor:

Anyone can approve (no restrictions)

Any user can undertake the approval.

Anyone can approve (no restrictions)	Who can approve or reject	Workflow state dialog box on the page
Open	There are no restrictions on who can approve or reject the approval. The user must have edit permission for the page. A single reviewer’s decision completes the approval. Use Minimum approvals to require two or more users to undertake and agree on the approval decision to complete the approval.	Open Open

For further information, see Workflow Builder: Anyone can approve it, and Content Reviews: Anyone can undertake the content review.

Users can be assigned through UI

Allow one or more users to be assigned as reviewers on the page using the workflow popup.

Users can be assigned through UI	Who can approve or reject	Workflow state dialog box on the page
Open	One or more users can be assigned as reviewers (using the workflow popup on the page). Only an assigned user(s) can undertake the approval. A user assigned as a reviewer only requires Confluence view permission to undertake an approval and must be logged into Confluence. Until a reviewer is assigned, any Confluence user (with view and edit permission for the page) can approve or reject to complete the approval. Automatically assign reviewers Includes the option to pre-assign users as reviewers by adding one or more user names or user group names to the Automatically assign menu options Preassigned users are assigned on the transition to the workflow state with the approval. Use Minimum approvals to require two or more users to undertake and agree on the approval decision to complete the approval. Set the Minimum approvals=1 to require a single user decision from multiple assigned reviewers to reduce blockages on non-critical approval steps.	The workflow state dialog box displays the Add reviewer option. Open Assigned users are displayed in the workflow state dialog box. Open Minimum approvals displays the required number of users as empty avatars in the workflow state dialog box. Open Reviewer decisions are appended to the user avatar in the workflow state dialog box. Open

For further information, see Workflow Builder: Assignable approval in workflow builder and Content Reviews: Manual assignment of Reviewers.

Once a user is assigned as a reviewer

• the approval buttons are disabled for a user who is not assigned

• additional users can be assigned as reviewers using the workflow popup on the page

• preassigned users can be unassigned using the workflow popup on the page

If more than one reviewer is assigned

• then all reviewers must agree on the approval decision (approved/rejected) for the approval to be completed

Until the approval is complete (all assignees have undertaken and agreed on the approval decision)

• additional users can be assigned as reviewers

• assigned reviewers can be unassigned if they have not undertaken an approval decision

Set all reviewers that have to approve

Mandate chosen users or members of a user group to undertake the approval

Set all reviewers that have to approve	Who can approve or reject	Workflow state dialog box on the page
Open	Preassigned reviewers must undertake the approval. Only the preassigned reviewers can undertake the approval. A user assigned as a reviewer only requires Confluence view permission to undertake an approval and must be logged into Confluence. Automatically assign reviewers At least one username or group name must be entered into the workflow builder approval editor using one of the Automatically assign dropdown menus. The users are preassigned as reviewers by the workflow on the transition to the workflow state containing the approval. In the workflow state, the page does not have a workflow popup option to assign additional users as reviewers or unassign the preassigned reviewers. Use Minimum approvals to require two or more users to undertake and agree on the approval decision to complete the approval. Set the Minimum approvals=1 to require a single user decision from multiple assigned reviewers to reduce blockages on non-critical approval steps.	User avatars for preassigned reviewers are displayed in the workflow state dialog box on the page. Open Reviewer decisions are appended to the user avatars in the workflowstate dialog box. Open

For further information, see Workflow builder: Workflow assignment of approval reviewers and Content reviews: Workflow assignment of reviewers.

On transition into the workflow state containing the approval

• the approval buttons are disabled for the approval for any user who is not preassigned

• unless a Minimum approvals value is set, all reviewers must undertake the approval and agree for the approval to be complete

Minimum approvals

Set a minimum number of reviewers to undertake an approval decision and agree to complete an approval.

This can be set for each of the approval Reviewers settings:

• Anyone can approve

• Users can be assigned through the UI

• Set all reviewers that have to approve

Minimum approvals	Who can approve or reject	Workflow state dialog box on the page
Open Open Open	Add a value for Minimum approvals to require one or more users to undertake and agree on the approval decision to complete the approval. when set the workflow popup displays empty avatars for the required number of approvals reviewer approval decisions are appended to the user avatar A value of zero is ignored. If you require automatic approval on transition into the state, you can add a workflow trigger with an approve action. Minimum approvals can be set for all three of the Reviewers options in the approval editor. Minimum approvals can be set for all three of the Reviewers options in the approval editor. If the selected Reviewers option includes assigned reviewers ( Automatically assign users, Automatically assign groups, or manually assigned reviewers) approval is set as complete when the Minimum approvals are undertaken and agree not all assigned reviewers need to undertake the approval decision to complete the approval if there are more assigned reviewers than the Minimum approvals value All reviewer decisions must agree to complete the approval (no contra decisions) even if there is the required number of agreed Minimum approval decisions.	Open Anyone can approve - 2 minimum approvals - no reviewers assigned - no reviewer decisions Open Assigned reviewers - 3 minimum approvals - two reviewers assigned - no reviewer decisions - one empty avatar Open Assigned reviewers - 3 minimum approvals - 2 assigned reviewers - one reviewer decision - one empty avatar

For further information, see Content reviews: Minimum reviewers

Minimum approvals example

For example, if the approval is configured as

• Set all approvers that have to approve

• 4 users to automatically assign

• Minimum approvals is 2

Open

On the page, the approval displays the preassigned reviewers.

Open

For the following reviewer approval sequences

Scenario 1

• first 2 approval decisions by different assignees are Reject

  • Minimum approvals is 2 and the approval is complete with status as rejected

  • the related reject transition occurs

Open

Scenario 2

• first 2 approval decisions by different assignees are Approve

  • Minimum approvals is 2 and the approval is complete with status as approved

  • any related approve transition occurs

Open

Scenario 3

• 1st assigned reviewer chooses to Approve

• 2nd assigned reviewer chooses to Reject

  • Minimum approvals is not yet achieved

  • approval status is pending

Open

• 3rd assigned reviewer chooses to Approve

  • Minimum approvals is 2 but no change occurs because there is a current contra decision for the approval

  • approval status is pending

Open

• 2nd assigned reviewer changes their approval decision from Reject to Approve

Open

The Reject contra decision for the approval is no longer current (all 3 reviewer decisions are Approve).

• Minimal approvals is 2

  • now 3 reviewer approved decisions with no contra decision

  • approval is complete with status as approved

  • any related approve transition occurs

Open

The 4th assigned reviewer was not required to make any approval decision.

Open

Document activity report: 4 assigned reviewers, 3 reviewer approved decisions

Related pages