---
title: "Assigning reviewers"
canonical: "https://support.appfire.com/space/CDML/650347935/Assigning%20reviewers"
format: markdown
---
> Macro (aura-html)


> Macro (toc)

## Overview

Users can be manually assigned, reassigned, and unassigned in a content review as [reviewers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/682360922).

- the content review must allow the manual assignment of reviewers
- the user assigning a reviewer has edit permission for the page

A content review can also be configured to [limit the users who can assign reviewers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152120/Edit+approvals#Who-is-allowed-to-assign-reviewers%3F).

[Reviewers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/682360922) can also be

- assigned automatically by the workflow
- limited by the workflow

> ✅ Limiting who can assign reviewers via workflow approval settings helps manage permissions, ensures oversight, and maintains review process integrity.

## How do I know if I can manually assign reviewers?

A content review in the workflow must be configured to be **[assignable](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152120)** and the assignor must have at least **edit **permission for the page or blog post.

In a state with a content review, look for the **+ Add reviewer** button next to the **Approve** and **Reject** buttons

![image](media://0784f8b9-3867-4828-8e01-13d371eb59eb)

If reviewers are already assigned, the add reviewers option is simply a “**+**” symbol.

![image](media://f67b0a86-8231-4667-9067-4e5b3f13a53a)

> ℹ️ The option to manually assign reviewers using the workflow popup is only displayed if the named approval (content review) is configured as **assignable** in the workflow

## Assigning reviewers

Click the **+ Add Reviewer **button on the [workflow popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846) – you will be presented with a search screen like the one shown below.

![image](media://619b298a-cc9d-4db6-8823-1f2949382f8e)

#### Searching

You can search by **full name**, **username**, or **email address**.

> ℹ️ You'll usually need to type two [or more](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649529530) characters before the results appear.

#### Assigning

When you've found who you're looking for, click the **grey button** on the right to assign them to the review.

![image](media://8d5701f5-118a-4661-97a0-ca5da423a7a3)

If you need to leave a note for reviewers, click the **Add a note **link and enter your note. They'll see it in notifications and emails.

#### Saving changes

- click the blue **Assign **button in the dialog box to save the reviewer assignments

The assignee avatars are displayed on the [workflow popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846)

![image](media://f67b0a86-8231-4667-9067-4e5b3f13a53a)

Comala Document Management suggests users specified in the `user`, `group`, `selectedapprover` or `selectedapprovers` parameter on the [approval macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662337). If these parameters are not specified, recent contributors to the page are suggested.

- the number of possible assignees displayed is a maximum of 15
- if the possible assignees specified using the `user`, `group`, `selectedapprover` or `selectedapprovers` exceed the default number of 15 a search is required

> 📝 Edit the default number for the list of possible assignees in the [Global Advanced Configuration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649529530).

## Unassigning and reassigning reviewers

To reassign or unassign reviewers, return to the assignment search screen by clicking the **small "plus" button** next to the list of the assignees (see the previous screenshot).

#### Unassign

- hover over the listed assignee "**check" button**
- click it to remove the assignee

![image](media://a8ce2439-ff03-4710-986f-db6c12bd72c0)

Choose** Unassign** to confirm.

> 📝 On this same screen, you can add new reviewers too – see **Assigning Reviewers** section above for details.

## See also

[User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144)

- [State Status Indicator Circles](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152863)

[Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833)

- [Activity Report - Content](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119122)
- [My Document Actions - Profile](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152557)
- [Workflow Report Macro - Approvals](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650120822)

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)

- [Approvals](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153766)
- [Roles and Permissions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217543)
- [Edit approvals using workflow builder](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152120)

[Administration Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649233819)

- [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054)
- [Advanced Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649529530)

| [‹ Back to Content Reviews](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650313809) |
| --- |