# About Workflow Building Blocks for Jira

Workflow Building Blocks’ app mission is to unlock the power of Jira Expressions for everyone—not just scripting experts. Our app combines **ready-to-use, no-code tools** with **advanced Jira expression capabilities**, giving admins both simplicity and full control over workflows. Whether you are an everyday Jira admin or a power user, you can create sophisticated conditions, validators, and post-functions with minimal effort—without writing a single line of code.

## Wizard-Like Conditions and Validators

Workflow Building Blocks provides a set of **wizard-style conditions and validators** designed to simplify workflow management. These tools allow you to extend Jira workflows in a **user-friendly way**, requiring no advanced knowledge to get started. You can take full control of transitions by limiting their visibility or adding conditions that must be met for a transition to succeed.

<figure><img src="https://4067441311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh6orV4J25NOSJvrMyLKk%2Fuploads%2FX1eVcUfx80tdJac8ZeOp%2Fwhen%20then.png?alt=media&#x26;token=25feafb6-9fa2-4349-813b-81be9976450e" alt="Ultimate Validator for Jira configuration with conditional requirements examples, demonstrating flexible workflow rules and field validation"><figcaption><p>Ultimate Validator configuration examples for enforcing mandatory fields conditionally.</p></figcaption></figure>

### Workflow Validators

* [Ultimate Validator](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/ultimate) - Compose highly customized validators visually using the UI
* [Linked Issues Validator](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/linked-issues) - Ensure related issues (linked issues, sub-tasks, stories, children or parent) are in the correct state before allowing a transition.
* [Dates Compare Validator](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/dates-compare) - Compare two date fields with flexible offsets.
* [Fields Required Validator](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/fields-required) - Checks whether a field has been filled in either during or prior to the transition.

### Workflow Conditions

* [Ultimate Condition](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/ultimate) - Compose highly customized conditions visually using the UI.
* [Linked Issues Condition](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/linked-issues) - Ensure related issues are in the correct state before a transition.
* [Dates Compare Condition](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/dates-compare) - Compare two date fields with flexible offsets.
* [Fields Required Condition](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/fields-required) - Checks whether a field has been filled in either during or prior to the transition.

### **Jira Expression Preview**&#x20;

Each wizard provides a [Jira expression preview](https://docs.forgappify.com/workflow-building-blocks-for-jira/testing-and-debugging/testing-conditions-and-validators#jira-expression-preview), allowing you to see how Workflow Building Blocks constructs the underlying logic. This preview is a **valuable learning tool**, enabling admins to understand and create Jira expressions more confidently while gaining insight into transition requirements.

<figure><img src="https://4067441311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh6orV4J25NOSJvrMyLKk%2Fuploads%2FNZq5D122n3PaAO2yB5FL%2Fpreview%20spotlight.png?alt=media&#x26;token=e45f47c6-0f67-4773-b64e-bbb1a697b928" alt="Screenshot of Jira Ultimate Validator setup page. The Linked Issue Validator is selected. In the configuration options, the relation is set to &#x27;linked issues&#x27;, filtered by link type &#x27;is blocked by&#x27;, and further restricted to status category &#x27;Done&#x27;. Below the configuration form, a Jira expression preview panel is visible, showing the automatically generated expression that reflects the chosen relation, link type, and status category"><figcaption><p>Linked Issue Validator configuration example with a preview of the generated Jira Expression.</p></figcaption></figure>

## Jira Expression Conditions and Validators

For advanced use cases, Workflow Building Blocks offers full support for **Jira expression-based conditions and validators**. The app includes an **advanced Jira expression editor** that provides suggestions, syntax highlighting, validation, and real-time feedback, making it easier to write complex expressions correctly.

* [Jira Expression Validator](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/jira-expression)
* [Jira Expression Condition](https://docs.forgappify.com/workflow-building-blocks-for-jira/conditions-validators/jira-expression)

<figure><img src="https://4067441311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh6orV4J25NOSJvrMyLKk%2Fuploads%2FTefa3oo23qmgiK8gy2ch%2Fconditionally%20require.png?alt=media&#x26;token=c5b5633a-1d69-4ae7-bc00-5f5bc296b1ab" alt="Screenshot of the Workflow Building Blocks for Jira app showing the Jira Expression Validator configuration. The screen displays an expression editor with autocomplete and syntax highlighting enabled, allowing administrators to write and test Jira expressions. Beneath the editor, there is a &#x27;Validation message&#x27; input field where a custom error message can be defined, which will be shown to users when the validation rule fails."><figcaption><p>Jira Expression Validator configuration with expression editor and custom validation message field</p></figcaption></figure>

## Post-Functions Now Available

Workflow Building Blocks now includes **ready-to-use post-functions**, expanding your automation capabilities beyond conditions and validators. These tools allow you to **execute complex, multi-step actions** with minimal configuration.

* [Transition Work Items](https://docs.forgappify.com/workflow-building-blocks-for-jira/post-functions/transition-work-items) – Automatically transition the current issue or related issues (parent, child, or linked) to the next available status in the workflow after a transition.
* [Edit Work Item](https://docs.forgappify.com/workflow-building-blocks-for-jira/post-functions/edit-work) – Automatically modify issue fields after a workflow transition and copy field values from the parent issue, up to two levels up in the hierarchy.

<figure><img src="https://4067441311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh6orV4J25NOSJvrMyLKk%2Fuploads%2FrkRiYOU03TQIwSScsS3c%2FHighlight%203.png?alt=media&#x26;token=03dc473c-c55c-4338-b9e0-19c1fe187d22" alt="Screenshot of the Workflow Building Blocks for Jira app showing the Transition Work Item post function configuration. The example setup automatically transitions the parent issue when the last of its child issues is moved to Done. The configuration panel displays powerful preconditions that allow inspection of the status of sibling issues, ensuring the parent transition occurs only when all children meet the required criteria."><figcaption><p>Transition Work Item post function configured to automatically transition the parent when all child issues are Done, using sibling status preconditions.</p></figcaption></figure>

With post-functions, admins can **save time, reduce errors, and maintain consistent workflows**, empowering teams to follow automated processes without coding.

### **Top 10 Use Cases for Workflow Building Blocks**

1. **Prevent closing issues with blocking links** – Prevent closing an issue if it has an “is blocked by” linked issue.
2. **Epic/task dependency enforcement** – Prevent closing an epic until all its tasks are completed and enforce story transitions only when the epic is in progress.&#x20;
3. **Sub-task status validation** – Validate the status category of sub-tasks for specific types.
4. **Date-based transitions** – Allow transitions based on dates set in the future or past, or by comparing two date fields with offsets in weeks, days, hours, or minutes.&#x20;
5. **Field-based conditions** – Make fields mandatory or conditionally required based on other field values, resolution, or issue type.&#x20;
6. **Assignee/reporter validation** – Compare two different fields, e.g., ensure the assignee is different from the reporter.
7. **Sprint & version validation** – Validate that an issue is part of an active sprint and ensure it is not associated with released versions.&#x20;
8. **Restrict actions to specific users** – Reserve the privilege of closing issues solely for their creators and control issue creation based on project role.&#x20;
9. **Edit multiple fields automatically** – Automatically edit multiple fields in an issue after a workflow transition.&#x20;
10. **Automated issue transitions** – Automatically transition the current issue or related issues (parent, child, or linked) to the next available status in the workflow after a transition.