Warsaw Dynamics
Documentation Hub
Advanced search
Log in
Warsaw Dynamics
Search
Jump to section
    Navigation
    Details
    Page options
    Subscription
    • Subscribed via parent page
    Links
    Documentation Hub
    Account
    Log in
    0/0
    Group step
    Approval Path for Jira
    Welcome to Approval Path for Jira How-to Guides Create an Approval Definition Step Types Group step
    Subscribed via parent page

    Group step

    • Group Step
      • Choosing the approver
        • Chosen group
        • Work item field
          • Resolve group(s) from field on
      • Action Type
      • Number of votes required for group step
        • Exclude from group
      • Skip this step if the group doesn't contain any users
      • Add comment on action
      • Watcher notifications
      • Conditions
        • Step condition
        • Label condition
      • How the group appears on the work item

    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.

    image-20261013-141550.png

    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.

    image-20261013-142144.png

     

    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.

    image-20261013-142441.png

    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.

    image-20261013-142624.png

    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.

    image-20260522-081752.png

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

    image-20261013-142810.png

    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.

    image-20261013-110513.png

    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.

    image-20251204-235710.pngimage-20260130-060544.png

     

    About us
    Our apps
    Documentation hub

    © Warsaw Dynamics, 2025. All rights reserved.