> For the complete documentation index, see [llms.txt](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/draft-review.md).

# Draft Reviews

Create reviews as drafts to ensure that results are as expected, act on rows, and make changes to reviewers before notifying participants.

### Overview

Operators can choose to create access reviews in an unpublished, draft state. When a review is in a draft state, it offers an opportunity for the operator to inspect the included rows and adjust default reviewer assignments before commencing the review and notifying reviewers and other stakeholders.

Notes:

* A draft stays unpublished until an operator publishes it or its scheduled publish date arrives.
* Reviewers cannot view any unpublished reviews, even when they contain rows assigned to them.
* Operators can act on any results in unpublished reviews, including approving or rejecting, assigning reviewers, and signing off. Veza does not send webhooks for reviewer assignments when reviews are in draft state. All other webhooks (such as actions configured to trigger on rejected row sign-off) will trigger as normal.
* Publishing the review sends notification emails triggered "On review start."

### Create a review as a draft

1. Create an access review: [Create a Review](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/create-access-review.md).
2. On the last step, select **Create Review** > **Save as draft**. To have the draft publish itself at a set time, select **Create Review** > **Publish later** instead. See [Schedule a draft to publish later](#schedule-a-draft-to-publish-later).

Reviews can also start as drafts without being created by hand:

* On a review schedule, select **Save as draft** under **Review creation** so every run the schedule creates starts as a draft. See [Schedule an Access Review](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/schedule-access-review.md).
* On a Lifecycle Management [Create Access Review](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/lifecycle-management/policies-workflows/actions/create-access-review.md) action, set **Creation Mode** to **Create as a draft**.

### Draft review actions

Operators can make changes to draft reviews without notifying assignees. To prepare a review, you might:

* Use the **Review Details** sidebar on the left to configure review-specific email notifications and Veza Actions.
* Add row-level reviewers with the **Reassign reviewers** action.
* Approve or reject rows you can immediately decide on.
* Add notes for other reviewers.
* Sign off on one or more rows using the **Sign-Off Selected** button at the top right.

### Publish a draft review

Review owners can publish drafts directly from the **Access Reviews** page:

1. Search for the draft review and open its **Actions** menu (⋮).
2. Select **Publish Now**.

To see active reviews and publish any drafts for a specific configuration:

1. Go to the **Configurations** page.
2. Use the search bar to find the configuration containing the review, and click to view **Configuration Details**.
3. In the **Reviews** section, open the draft review's **Actions** menu (⋮) and select **Publish Now**.

### Schedule a draft to publish later

{% hint style="info" %}
**Available starting with Veza v2026.10.26.** In earlier releases, a draft is published only when an operator publishes it.
{% endhint %}

**Before you start**, confirm your role. Scheduling or publishing a single review requires the Admin, Access Reviews Admin, Operator, or Access Reviews Monitor role, with access to the review's configuration. Scheduling in bulk requires the Admin, Access Reviews Admin, or Operator role. See [Roles](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/administration/administration/users/roles.md).

A draft can publish itself at a date and time that you choose. Veza checks for scheduled drafts every 15 minutes, so a review publishes within about 15 minutes after its publish date. A scheduled draft publishes the same way as one published by hand: the review starts, reviewers can see it, Veza sends the notifications triggered by **On review start**, and any Veza Actions mapped to **Review published** run. A draft that is still being generated at its publish date publishes at the first check after it is ready.

To schedule a new review:

1. On the last step, select **Create Review** > **Publish later**.
2. In **Choose date to publish**, select the date, time, and time zone. The time zone defaults to your local time zone.
3. Select **Schedule Review**. Veza saves the review as a draft until the publish date.

To schedule an existing draft or change its schedule:

* On the **Access Reviews** page or in the **Reviews** section of **Configuration Details**, open the review's **Actions** menu (⋮) and select **Set Publish Date**. For a draft that is already scheduled, the menu offers **Edit Publish Date** and **Unschedule**.
* In the reviewer interface, open **Review Details**. **Publish Date** shows the scheduled date, with **Edit** and **Clear**.
* In **Change Settings** for an unscheduled draft, select **Save Changes** > **Publish later**. For a scheduled draft, the **Scheduled to publish** alert at the top offers **Change** and **Remove**, which take effect when you select **Save Changes**.
* To schedule several drafts at once, select them on the **Access Reviews** page and select **Set Publish Date**. The bulk action is available only when every selected review is a draft.
* The bulk action sets a publish date but cannot clear one. Drafts whose dates do not allow the chosen publish date are skipped and reported as failed.

The publish date must meet all of these conditions:

* It is in the future.
* It is no more than one year after the review was created.
* It is before the review's due date and before every approval level's due date.

While a draft is scheduled, its due date cannot be set earlier than the publish date. Removing the schedule leaves the review a draft. **Publish Now** publishes a scheduled draft immediately.

On the **Access Reviews** page, a clock icon in the [**Publish Date** column](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/manage-access-reviews.md#managing-active-reviews) marks a scheduled draft.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/how-to/draft-review.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
