# Approval thresholds

{% hint style="info" %}
This feature requires a license - learn more about [Workflow's licensing model](https://umbraco.com/products/umbraco-workflow)
{% endhint %}

Umbraco Workflow's default behavior requires one member of an approval group to approve a pending task to advance it through the workflow.

The approval thresholds feature introduces configuration options to set the required number of approvals for a given workflow stage.

The threshold options are:

| Option          | Description                                                                                                                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| One (*default*) | Pending tasks require approval from **any** member of the assigned approval group.                                                                                                                          |
| Most            | <p>Pending tasks require approval from an absolute <strong>majority</strong> of group members.<br>Example: A group with 3 members requires 2 approvals and a group with 4 members requires 3 approvals.</p> |
| All             | Pending tasks require approval from **all** group members.                                                                                                                                                  |

The workflow detail UI displays the following:

* The status of the current task.
* Approval status for members of the current group.
* Progress towards meeting the threshold for the current approval stage.
* Future tasks and the assigned group and its users.

![Tasklist with approval thresholds](https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-7ec1fe7f805ede7cc5eabb454f1b7160fd76c11e%2Ftasklist-with-approval-thresholds-v14.png?alt=media)

Approving a task as an administrator immediately satisfies the approval threshold for the task, and will advance to the next workflow stage.

When a task is rejected in a workflow stage where the approval threshold is Most or All, existing approvals can be managed via configuration:

* Existing approvals can be reset, resetting progress toward the approval threshold. In this case, all users in the approval group will be able to approve the resubmitted content.
* Existing approvals can be kept. In this case, users in the approval group who have already approved the task will not be able to approve the resubmitted content.

## Related settings and configuration

Approval thresholds are managed via settings in the Workflow section or in the `appsettings.json` file. Node-specific thresholds are set directly on the workflow configuration in the Workflow content app.

### Settings

The settings below can be set from the Backoffice or via settings customization in the `appsettings.json` file (refer to [Settings customization](https://docs.umbraco.com/umbraco-workflow/configuration#settingscustomization) for implementation instructions).

| Setting                      | Default   | Description                                                                                                                    |
| ---------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Approval threshold           | `0` (One) | Sets the global approval threshold.                                                                                            |
| Rejection resets approvals   | `false`   | When `true`, and the approval threshold is Most or All, rejecting a task resets the previous approvals for the workflow stage. |
| Configure approval threshold | `false`   | When `true`, enables setting the approval threshold for any stage of a workflow (on a content node or Document Type).          |

### Configuration

The approval threshold for an individual workflow stage can be set using the control below the stage name. Setting the stage threshold requires the **Configuring approval threshold** setting to be `true`.

![Setting approval threshold for individual workflow stages](https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-60f82da35b755327280be5e7a71d4fd147199e0e%2Fapproval-flow-with-thresholds-v14.png?alt=media)


---

# 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.umbraco.com/umbraco-workflow/getting-started/approval-thresholds.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.