Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this section

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printabletrue

Overview

Approval allows users to automatically transition an Issue that meets the specified conditions by either approving or rejecting it.

Start by accessing the Project Settings module. Here, you can set up approval processes for different requests.

Creating Approval involves several steps to define the Approval criteria and behavior.

Access the Approval For Jira application in project

  • Navigate to the sidebar of your Jira instance.

  • Locate the "Apps" group.

  • Within the "Apps" group, find and click on the "Approval for Jira" app module.

image-20240905-083818.png

Click on the "Add Approval" button. This will open the Approval Configuration interface where you can set up the criteria and process for your approval.

image-20240905-174520.pngImage Removedimage-20241126-042205.pngImage Added

Steps to Create an Approval:

🎯 Step 1 - Naming & Select the Approver(s)

  • Specify a descriptive Approval Name: You need to specify the name

clearly indicate
  • indicating the purpose of the Approval (e.g., "Review Design", "Code Review").

  • Assign appropriate Approvers: Determine who should have the authority to approve or reject Approval. You can assign individuals, groups, or departments based on their roles and expertise.

Note

Note: The Approval name for Approval must be unique and cannot be duplicated.

image-20240905-090127.pngImage Removedimage-20241125-070104.pngImage Added

🎯 Step 2 - Select Issue Type and Source Status

Specify
  • Select Issue Type: Select the appropriate Issue Type (e.g., Bug, Task, Story).

Indicate
  • Select Source Status: Choose the relevant Source Status (e.g., Open, In Progress, Resolved) to focus on issues at specific stages of the workflow.

Add More Conditions
  • Additional Filter(Optional): Utilize the Additional Filters option to refine your approval criteria further. This option allow selecting Custom

Fields
  • Fieldwith equivalent

values
  • value.

  • Skip transitions (Optional): Check this box if you want tobypass the transition step.

This option is useful when you don't need to automatically move the request to a new status after approval or rejection
  • To prevent an automatic transition and require manual intervention afterApproval process.

Note

Note: Current Limitations of Additional Filters

  • Single Custom Field: The Additional Filters option currently supports only one custom field.

  • Supported Custom Field TypesValue: Only custom fields of the SELECT can be used. Other field types (e.g., text, checkbox, string, date, number, option) are not supported.

Screenshot 2024-04-02 at 11.20.49.pngImage Removed

There are 2 case scenarios:

Case Scenario 1:

To automatically move a task to the next stage of your workflow after approval, follow these steps:

  1. Select Issue Type: Choose "Task."

  2. Select Source Status: Choose "Open."

  3. Leave Skip Transitions unticked.

Result: The task will automatically transition to the designated status based on your workflow configuration.

Screenshot 2024-04-02 at 11.20.49.pngImage Removed

Case Scenario 2:

To prevent an automatic transition and require manual intervention after approval, follow these steps:

  1. Select Issue Type: Choose "Task."

  2. Add Additional Filter: Select the "Change type" custom field and set its value to "Standard."

  3. Select Source Status: Choose "In Progress."

  4. Check Skip Transitions.

Result: When the task is approved, it will remain in the "In Progress" status. You will need to manually transition it to the next stage of your workflow.

Screenshot 2024-04-02 at 11.21.32.pngImage Removed
  • the custom field value of the selected custom field is available for selection.

image-20241125-072327.pngImage Added

🎯 Step 3 - Select Approval Transition

(Optional)

  • Select Destination Status: Choose the desired Status that the issue will transition to once it's Approved (e.g., "Resolved," "Closed," "In Review").

Note

Note: Approval for Jira currently only supports directed transitions, meaning allows you can specify a specific destination status for approved or rejected issues.

Screenshot 2024-04-02 at 11.23.33.pngImage Removed

image-20241125-072520.pngImage Added

🎯 Step 4 - Select Decline Transition

(Optional)

  • Select Destination Status: Choose the desired Status that the issue will

transition
  • be transitioned to if it's Declined (e.g., "Reopened," "Rejected," "Closed").

Screenshot 2024-04-02 at 11.23.43.pngImage Removed

image-20241125-072557.pngImage Added

🎯 Step 5 - Configure Approval Condition(s)

  • All Approved: Select this option if you require Approval from all assigned Approvers before the issue can transition.

  • Minimum Approval: Specify the minimum number of Approvers needed for the issue to transition. This allows for scenarios where a majority vote is sufficient.

Screenshot 2024-04-02 at 11.24.54.pngImage Removed

image-20241125-072644.pngImage Added

🎯 Step 6 - Add OLA (Optional)

  • Time Target: Set the OLA for approval to create a clear timeframe for making both approval and rejection decisions.

Note

Note:

  • The required time target format should be expressed as: “h” “m”.
    For example: 1h 30m.

  • Only hours and minutes are allowed.
    For example: 1h, 2h, 30m or 45m.

  • An email notification will be dispatched to the approvers as the deadline for the ola approaches.

image-20241125-072727.pngImage Added

🎯 Step 7 - Review and Confirm

  • Verify Settings: Carefully examine the summary to ensure that all settings are correct and aligned with your intended approval process.

  • Make Adjustments: If necessary, modify any settings that are incorrect or do not meet your requirements.

Screenshot 2024-04-02 at 11.25.40.pngImage Removed

image-20241125-075140.pngImage Added

Use Case

Approval are essential mechanisms for ensuring that decisions are made consistently, efficiently, and with appropriate authorization. They are particularly valuable in scenarios where accuracy, compliance, or resource allocation are critical.

To learn more about specific use cases and best practices for implementing Approval, please visit our dedicated page:

This page is here to offer you detailed insights on leveraging approvals to streamline your business operations.

Strict Approval Process

These settings are designed to enhance the stringency of the Approval setup and mitigate potential risks effectively.

This page will provide the necessary setup for making the Approval setup more strict.