Group step
Group Step
A Group step asks the members of a Jira group to decide. You either pick the group in the definition, or take it from a work item field.
Choosing the approver
Chosen group
You name the group here, in the definition. Every approval built from this definition goes to the same group. Search for it in the Group field.
Work item field
The group is read from a field on the work item, so each approval can go to a different group. Search for a group field in the Work item field box.
Both standard fields and custom fields can be used. For custom fields, that means a group picker or a multi-group picker.
Picking Description builds the step from the groups mentioned in the work item's description. See Work Item Fields - Description for how that works.
Resolve group(s) from field on
When the field is read, either at Approval start or at Step start. Reading at step start picks up changes made to the field while earlier steps were running.
If the field holds no group at the moment it is read, the step is skipped, or the approval is not created at all.
Action Type
Type |
What it does |
|---|---|
Approval |
The approver approves or rejects, and can abstain if that is enabled. A decision is final. The only way to undo one is to delete the approval and start again, which requires the right permissions. |
Consent |
Behaves the same way as Approval. The wording differs, which matters in some organizations, but Approval Path treats them identically. |
Notification |
No decision is asked for. The step tells someone what is happening and moves on. Notification suits people who follow an approval without taking part in it. Two common uses are telling stakeholders at the start that something has begun, and telling a team lead at the end that access has been granted. |
Number of votes required for group step
Applies to Approval and Consent only.
To pass is how many approvals the step needs before it completes and the approval moves on.
To fail is how many rejections it takes to fail the step. Setting it above 1 means a single rejection does not stop the approval. With 2, the first Reject leaves the step running, and only the second one fails it.
Exclude from group
Takes people out of the group for this step, even though they belong to it.
Option |
What it does |
|---|---|
Approval creator |
Excludes whoever started the approval, so nobody approves their own request. |
Users |
Specific members you pick. The list is drawn from the chosen group, so it only works with the Chosen group source. With a work item field there is no group to draw from, and the control stays empty, reading Select a group first. |
Users from custom fields |
Excludes whoever the chosen fields hold, resolved per work item at the time the step is evaluated. Single and multi-user pickers are both supported, and you can mix several fields in one box. An empty field simply excludes nobody. |
With a work item field, use Approval creator and Users from custom fields to exclude people, since neither needs the group to be known in advance.
Skip this step if the group doesn't contain any users
Leaves the step out of the approval when the group turns out to be empty, rather than stalling on approvers who do not exist. The approval carries on without showing a message about the empty group.
Add comment on action
Turn on Add comment on each action and choose which decisions require one: Approval, Reject, or Abstain (if available).
Requiring a comment means the approver has to say why, which gives the assignee something to work with and keeps the reasoning on the record.
Watcher notifications
Notify watchers when this step is decided sends the work item's watchers an email whenever a decision is taken on this step. This can also be controlled instance-wide in the notification settings. The setting here turns it off for this step alone.
Conditions
Step condition
A step condition decides whether the step is part of the approval at all. Select a condition built from a Jira expression, and the step is included only when that condition is met.
If the condition is not met, or it errors, the step is left out of the approval.
Refer to our documentation for comprehensive details on conditions.
Label condition
A label condition does the same job using the work item's labels.
Field |
What it does |
|---|---|
With labels (required) |
The work item has to carry these labels. |
Match mode |
Any label (OR) includes the step when at least one required label is present. All labels (AND) needs every one of them. |
Without labels (excluded) |
The work item must not carry these labels. |
If the work item satisfies the condition, the step is added to the approval. If not, it is skipped.
How the group appears on the work item
There is an option to expand the group step to display users, with the default view showing a compact version. When you hover over the person icon, a tooltip saying Click to view members appears, allowing you to check the group members.