# 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)