# Assign Reviewers

### Overview

When creating a review, operators will specify one or more reviewers for all the rows. They can also automatically assign rows to the applicable user’s manager or resource owner when auto-assignment is available.

After creating a review as a draft, operators can assign reviewers for each row and validate auto-assignments. Once the review starts, reviewers can reassign their work to others as needed.

Reviews can involve many different reviewers, who might be assigned only some of the rows in a review:

* By default, the possible reviewers are Veza local users or external users who have logged in with single sign-on.
* Reviewers can have the "Access Reviewer" role which limits the reviewer to essential review functions within Veza Access Reviews. See [User Management](/4yItIzMvkpAvMVFAamTf/administration/administration/users.md) for possible user roles.
* See [Configuring a Global Identity Provider](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/global-idp-settings.md) to show all users in your organization as possible reviewers. This also enables manager auto-assignment.
* Veza can identify and assign [Entity Owners and Resource Manager Tags](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/managers-and-resource-owners.md) as individual reviewers for each row.
* See [Notifications and Reminders](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/email-notifications.md) to inform reviewers and other stakeholders by email when rows are re-assigned or other actions occur.

{% hint style="info" %}
**Assigned reviewer permissions**: Any user assigned as a reviewer on specific review rows receives reviewer-level permissions for those rows, regardless of their [platform role](/4yItIzMvkpAvMVFAamTf/administration/administration/users/roles.md). This includes the ability to approve, reject, sign off, add notes, and reassign rows.

For example, a user with the **Watcher** role (normally view-only) can act on rows where they are assigned as a reviewer, while remaining an observer on other reviews. This supports flexible delegation workflows where users can take action on assigned items without requiring a role change. Whether assigned reviewers can reassign rows is controlled by the [**Enable Reviewer Reassignment**](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/access-review-settings.md#enable-reviewer-reassignment) setting in **Access Reviews** > **Settings**.
{% endhint %}

### Assign reviewers during review creation

When creating a review, operators may optionally assign one or more *default* reviewers. These reviewers are designated to act on all rows in the review.

To add default reviewers:

1. On the **Configurations** page, find the configuration you will create a review for.
2. Click the review name to open the **Details** page.
3. Click **New Review** to open the review creation wizard.
4. Under **Assign Reviewers**, choose users from the list to assign them as reviewers for all rows.

   ![Adding reviewers when creating a review.](/files/F2dIfHSvb5TRay0gs6Ql)

#### Auto-assign reviewers

Auto-assignment will delegate decision-making to users Veza can identify as the manager of an identity under review, or the owner of a resource the identity can access. Veza supports auto-assignment both for all rows at review creation, and for selected rows when re-assigning reviewers.

* **Managers** are identified by a user's `manager` attribute from the global IdP.
* **Resource owners** are identified by Veza tag on the destination resource, added by API or from the *Access Visibility* > *Graph* actions sidebar.
* **Fallback Reviewers** are assigned when a manager or resource owner cannot be found. Fallback reviewers are also used when a rule, such as a potential reviewer being on the deny list, would prevent the assignment.

To auto-assign reviewers when creating a review:

1. On the **Configurations** page, find the configuration you will create a review for.
2. Click the review name to open the **Details** page.
3. Click **New Review** to open the review creation wizard.
4. Under **Assign Reviewers**, enable an option to **Auto-Assign Reviewers**:

   ![Auto-assigning reviewers during review creation.](/files/2MZWwX5gGmJXFku1vAz3)

See [Reviewer Selection Methods](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/reviewer-selection-methods.md) for more on fallback behavior and rules.

You must integrate a global identity provider (IdP) for Access Reviews to enable manager auto-assignment. For more details, see [Entity Owners and Resource Manager Tags](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/managers-and-resource-owners.md).

### Reassign row-level reviewers

Once a review is in progress, operators and assigned reviewers can re-assign rows to another reviewer. In the reviewer interface, the *Reviewers* column shows any *non-default reviewers* for each row.

To reassign reviewers for a row:

1. Expand the row actions dropdown menu (⠇) and click **Reassign Reviewers**.

   ![Reassign reviewers with a row action](/files/LLwOfQyqs0Se1dCJbFnP)
2. Choose from the list of possible reviewers to reassign the row, or enable an auto-assignment method:

   ![Reassignment options.](/files/dm2w9m758pp6e6YSJebZ)

{% hint style="warning" %}
**Decision Clearing**: When you reassign a row that already has an approval or rejection decision, Veza displays a warning that the existing decision will be cleared. This ensures the new reviewer makes their own independent decision. The Action Log tracks these changes with `DECISION_CLEARED` events for full audit visibility into decision ownership transfers.
{% endhint %}

### Reassign row-level reviewers with a bulk action

In the reviewer's interface, you can use a bulk action to reassign many rows at a time:

1. Tick the boxes to enable bulk actions on several rows.
2. Click **Reassign Reviewers** above the table of results.

   ![Reassign reviewers with a bulk actions](/files/GNi4cQRhVPMH0Tz8Sbcb)
3. Assign reviewers by type to search for a username or email, or auto-assign the user manager or resource owner.
4. Confirm your selection and click **Save**.

See [Filters and Bulk Actions](/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/bulk-actions.md) for more information about combining bulk actions with filters for efficient review workflows.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/assign-reviewers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.