| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Overview
| Excerpt | ||
|---|---|---|
| ||
Define who can take part in, or be assigned to, a content review. |
These examples show several configurations of the approval macro parameters that control who can take part in, or assign users to a content review.
View-only users
Users who only have Confluence view permission can take part in a content review so long as they can see the workflow popup.
| Info |
|---|
Requires the Workflow Activity and Drafts Visibility admin option to be set to the default setting of Anybody. |
No assignment
| Excerpt | ||
|---|---|---|
| ||
By default, a content review added to a workflow does not allow reviewer assignment.  The workflow popup in the content review state displays only the Approve and Reject option buttons. Any single user with Edit content permission can Approve or Reject the review. A single reviewer approval decision (approved or rejected) causes the transition of the workflow. |
...
Assign anyone
| Excerpt | ||
|---|---|---|
| ||
To allow anyone to be assigned, add the The workflow popup displays the + Add reviewer button.  In this scenario:
|
...
Limiting reviewers
Making an approval assignable is one way to limit reviewers. But anyone can still approve the review if a user has not yet been assigned.
...
Excluding reviewers
| Excerpt | ||
|---|---|---|
| ||
You can use the The Approve and Reject buttons appear disabled for the excluded users. 
The A common exclusion use is for the person who created the content. This can be achieved with the |
| Code Block | ||
|---|---|---|
| ||
{workflow:name=No assignment}
{state:Editing|submit=Review}
{state}
{state:Review|approved=Published|rejected=Editing}
{approval:Review|assignable=true|exclude=@creator@}
{state}
{state:Published}
{state}
{workflow} |
Minimum reviewers
| Excerpt | ||
|---|---|---|
| ||
ou can specify how many people must be assigned to undertake the approval of the content using the The workflow popup will indicate the number of reviewers required by displaying a number user outline avatars corresponding to the minimum number of reviewers required.
 Users are assigned as reviewers by choosing the + icon in the popup. Any user can undertake the approval if no users are assigned All assigned reviewers would have to agree on either Approve or Reject in order to complete the review. For the Approve decision, the number of review decisions must also at least meet the minimum requirement if present.  |
...
If more than one reviewer is assigned you can fastrack a reject transition by adding a trigger to the workflow. This negates the need for all assigned reviewers to agree on a Reject decision for the rejected transition to take place.
Limiting assignment
You may want to limit which users or groups are allowed to assign a reviewer for the approval i.e., who can be an assigner. You can choose to use the allowedassignusers and/or the allowedassigngroups parameter.
...
| Code Block | ||
|---|---|---|
| ||
{approval:Review|assignable=true|allowedassignusers=!horst,ahmed} |
Limiting selection
If you want to limit which users or groups can be assigned to a review, use the user and/or group parameters.
...
If you don't require users to be assigned prior to reviewing, you can remove the assignable parameter. Only the users listed by the group and/or users parameters will be able to Approve or Reject, without the need for assignment.
Automatic assignment
| Excerpt | ||
|---|---|---|
ou can set all users who must approve the content. This is usually done by the workflow automatically assigning users as reviewers to to an approval on transition into the workflow state containing the content review. .png?version=1&modificationDate=1731608568574&cacheVersion=1&api=v2&width=503) One or more Confluence users, and/or one or more Confluence user groups can be added as the users who are assigned.
|
...
At least one assignee
The selectedapprovers parameter allows you to specify one or more users and/or groups, and automatically sets minimum=1.
...
Exactly one assignee
If you want to mandate that one person is assigned, and no more, use the selectedapprover parameter.
...