Approval thresholds
Use thresholds to configure how many approvals a workflow in Umbraco Workflow requires to be considered complete.
Last updated
Use thresholds to configure how many approvals a workflow in Umbraco Workflow requires to be considered complete.
Last updated
This feature requires a license - learn more about Workflow's licensing model
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 | Pending tasks require approval from an absolute majority of group members. Example: A group with 3 members requires 2 approvals and a group with 4 members requires 3 approvals. |
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.
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.
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.
The settings below can be set from the Backoffice or via settings customization in the appsettings.json
file (refer to Settings customization for implementation instructions).
Setting | Default | Description |
---|---|---|
Approval threshold |
| Sets the global approval threshold. |
Rejection resets approvals |
| When |
Configure approval threshold |
| When |
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
.