[object Object]

How-To Guides

Product Demo

In this five-and-a-half-minute demonstration video, we highlight the features of Flower that support the entire BPM lifecycle. Also we guide you through the Flower user interface.

Flower and Business Process Management

Flower for Jira is based on process models (process definition) and business process instances.

You define process models using the Flower BPMN Designer, a graphical editor, in the Flower UI. After you publish a process model, it is available in Jira.

Process Models (process definitions)

A process model represents a business process and describes the tasks (activities) involved in the process. Flower uses the Business Process Modelling Notation (BPMN) to draw a model picture.

A process model has the following characteristics:

  • A process model is static. The actual execution of the process model is described by the process instance, which holds the run-time information.
  • A process model is versioned. Each time a process definition is published, a new version of that process definition is made available to users. The new version is used for process instances which are started after it is published; it does not affect any process instances that are already running.

Process Instances

As users work in Jira and Flower, they launch instances of process models. A process model can have an unlimited number of process instances in progress at any given time.

Administrators can view and terminate active process instances. For more information, see Managing process instances.

Create a Flower Model

Designing a process model involves knowing your business, understanding the process, planning the workflow participants, and designing the task views.

Sample workflows are provided with Flower to get you started quickly. You can use them as templates and learning tools for your own workflows. You can find the list of example process models here.

How to create a Flower model

Using the Flower BPMN Process Designer

The Flower BPMN Process Designer is a graphic interface you use to define, publish, and manage BPMN processes. The Business Process Modelling Notation (BPMN) is used to design a process model and is the global standard for process modeling and one of the most important components of successful Business-IT-Alignment.

A fully documentation of the BPMN standard can be found here (The Ultimate Guid to BPMN).

To open the Flower BPMN Process Designer, access your Flower model repository and click at the pencil button at your selected model. Whether the menu item is displayed, depends on your Jira access permissions.

Edit model control

BPMN designer control

  • Click the circle to the right to start building.
  • Click or drag a rectangle to create a task. Type to name it.
  • Create an end event by selecting the thick circle. |

Set Jira project and Issue type

Flower creates for each process model activity (rectangle) a Jira issue. Therefore you have to tell Jira which project and issue type to be used. If nothing is selected, default values apply (see settings section)

Flower add Jira Project

Add Jira labels

Labels in Jira are tags or keywords that you can add to Flower process models to show whether they possess certain characteristics. Later labels can be used to be included in a Jira JQL query and aid you to group your process model repository.

Use the "archive" label to hide process models from your repository page.

Flower Labels

Flower Token Simulation

A picture is worth a thousand words - and a moving token is worth a whole bunch of static BPMN diagrams.

The simple token simulation aids your understanding of a diagrams semantics; to understand wait, join, and split semantics. It is a good starting point to learn BPMN execution in a playful manner.

Flower Token Simulation

Process Validation

Flower can check if your process model align with some basic rules to produce a valid BPMN file. Green markers stick at valid nodes; yellow and red markers indicate warnings and errors.

But Flower is very tolerant: Valid BPMN is not necessary in order to publish a model or to launch a process instance.

Flower BPMN Validation

Publish Model

A process model is versioned. Your actual drawing is the draft instance. In order to create a new version you have to publish the process model.

Each time a process model is published, a new version of that process model is made available to users. The new version is used for process instances that are started after it is published; it does not affect process instances that are already running.

Flower BPMN Validation

Model Version Navigator

Each time you published a BPMN model, it creates a new version automatically, preserving the previous version. This allows the users to revert to a previous version if necessary, compare different versions of the model, and track the evolution of the process over time.

To navigate through your previous versions, click "Versions" in the three-dots-menu at the top right in the Flower BPMN modeler.

Launch a Process Instance

Launching a process instance means to start a specific instance or execution of your pre-defined BPMN model. When a process instance is launched, the process begins to execute.

As the process instance progresses, it may move through various stages or tasks, and may involve different actors or participants. The process instance will continue to execute until it reaches its final end event.

To create a process instance click at the "play" button at your selected process model:

How to create a Flower process instance

You can even create multiple (or all) tasks in advance to schedule them in your Jira board and make them available for the next team planning. Once a task is resolved (or its status has changed), it will be displayed in your BPMN graph. Click the small status indicator on an activity to open the associated Jira ticket.

Jira statuses are displayed in your BPMN graph

Mapping between BPMN activities and Jira issues

When Flower creates a Jira issue, it is pre-filled with information from your BPMN model. Of course, the BPMN graphic with real-time status is also displayed on the Jira ticket. Mapping between a BPMN activity and a Jira issue works as described in the following table:

BPMN ActivityJira issue
Activity nameIssue summary
Activity documentationIssue description
ProjectIssue's Jira project. The default project applies if no value was provided.
Issue typeIssue's type. The default issue type applies if no value was provided.
Link(Confluence) link, attached to the Jira ticket. This could be useful to provide detailed procedural instructions at this step.
SwimlaneIssue assignment
Previous activitiesAll previous issues need to be resolved to proceed with the current ticket. To achieve this behaviour, the Flower Workflow Validator must be added to your Jira workflow transitions.

Also structures like Epic -> Story -> Task -> Sub-tasks can be automatically created by flower, when launching a process instance.

Managing Process Instances

As a process owner you want to control and monitor the the progress of the process execution, identifying and addressing any issues or obstacles that arise, and making decisions or taking actions to ensure that the process is executed efficiently. Here you can find all process instances related to a process model on one place:

How to manage your Flower process instances

Of course, you can also use a Jira search filter to manage all process instances. This might fit better in your daily work with Jira. The result of the following JQL expression will be all process instances for a certain BPMN model:

flowerModel=YOUR-MODEL-KEY AND flowerType in ("Process Instance")

learn more about using JQL with Flower

Gateways and Decision Handling

To automate BPMN gateways, you need to make decisions. In Flower, all decisions are made manually by the process owner at the process startup or during execution. You make decisions by launching one of the subsequent activities after the gateway. Depending on the gateway type (inclusive OR or exclusive XOR) you can select one or multiple successors.

If you come from another BPM system like Camunda or jBPM, you may expect decision gateways to be more strict or hard-wired, but Flower focuses on people-oriented management and project-like processes where a higher degree of flexibility is required.

Actually, there is no automatic decision calculation based on Jira fields yet, but this is already on the development roadmap.

Use Jira Forms and Confluence with Flower BPM

One of Jira's core features is the ability to create custom forms to capture information related to those tasks, issues, and projects. These forms can also be used to gather information and data related to your Flower business process, such as tracking customer inquiries, managing employee onboarding, or tracking the progress of a specific project. Jira forms can be customized to fit the specific needs of your business process.

How to use Jira Forms with Flower Process Automation

Another way to add forms and documents to your process is linking a Confluence page. It can be a page with process instructions to support the user with more details on the current task as well as a Confluence form. Learn more about how to use Jira Forms for your Flower business process.

Export and Import your BPMN file

Export your BPMN file

You can migrate process models from one environment to another environment using Export and Import buttons from the UI. Also if your favourite process designer supports the BPMN format, it is very likely that it is able to import Flower process models.

BPMN diagrams are typically saved in a XML file format with the .bpmn file extension. These files can be opened and edited with various BPMN modeling programs.

How to export a Flower BPMN model

Compatible BPMN modeling tools include among others:

  • jBPM an open-source Eclipse plug-in for creating and editing BPMN diagrams.
  • Camunda Modeler - open-source, cross-platform tool for creating, editing, and analyzing BPMN diagrams.
  • Visio - Microsoft's proprietary diagramming and vector graphics software, which includes support for BPMN diagrams.
  • Signavio - a cloud-based BPMN modeling tool that supports collaboration, simulation, and process automation.
  • IBM Business Process Manager - a commercial BPMN tool from IBM that supports process modeling, execution, and monitoring.
  • Lucidchart - a web-based diagramming tool that supports BPMN and other diagram types.
  • BPMN Modeler for Confluence - A Confluence plugin to model BPMN diagrams without automation support.

Import your BPMN file

You can migrate process models from one environment to another environment using Export and Import buttons from the UI. Also all exports from other Process Designers, which produce the standard BPMN format, can be imported by Flower.

How to import a BPMN model


Flower app does not come with an own data storage, all data (BPMN models, process instances, etc.) have to be saved as Jira tickets. To create a ticket, Jira needs to know project and issue type - therefore we have to tell Flower which values for those parameter should be used for each entity type. Flower handles 3 different object types:

  • The BPMN model is the graphical representation of you process. It is saved as a Jira ticket which contains all versions of a Flower process.
  • A process instance will be created when clicking on the play button at your BPMN model. It is saved as a Jira ticket.
  • It creates a task for each activity in your BPMN model when starting a process instance. Indeed, a task is a Jira ticket. By default, project and issue type are used from the global Flower settings, but it can be specified separately at each activity in your BPMN model as well (see Process Instances).
Flower Configuration guide

These values are managed by a business process owner. Access is not limited to a Jira administrator.

Jira Workflow Validator

Per default you can create and resolve all Flower tasks as you want without restrictions. However, you may want to ensure that all tasks are completed in the order described in your BPMN model. To do this, you need to tell Jira that transitions are not allowed until all previous tasks are also marked as completed.

For this purpose, Flower provides a Jira Workflow Validator, which can be added to any transition in your Jira workflow:

Jira Workflow Validator

It applies only for Flower related tasks and allows the transition to be taken only if there are no open previous tasks. Otherwise, an attempt to resolve the task will fail with an error message.


  • The Flower Workflow Validator only applies to Flower related issues. All other Jira issues remain untouched.
  • You need to be Jira administrator to edit a Jira workflow.
  • The validator condition is calculated based on the issue links attached to the Flower process instance (which is also a Jira issue). This means that the validator only takes existing issues into account. BPMN activities without a Jira ticket are not affected, nor are manually deleted issue links.
  • Instead of the above described Flower Workflow Validator you can also use the Flower Workflow Condition, which works the same way as the validator but hides the "resolve" button completely.
  • If you want to learn more about Jira workflow validators and conditions, check out this documentation.

Search Flower Models in Jira JQL

As all Flower entities like Process Model, Business Process Instances and Tasks are persisted as Jira Objects you can search for those by JQL.

Flower JQL Advanced Search

The Jira Query Language (JQL) is used to filter and search for issues across multiple projects, and it can be used to find issues that match specific conditions such as those assigned to a specific user, or those that have a specific status or priority. To find more about JQL and advanced search in Jira, this documentation is a good starting point.

The most common Flower search expressions:

  • Search for all Flower entities:
    flowerType in (Model, "Process Instance", Activity)
  • Search for all Flower Process Models:
    flowerType in (Model)
  • Search for all Flower Business Process Instances:
    flowerType in ("Process Instance")
  • Search for all Flower Workflow Tasks:
    flowerType in (Activity)
  • Search for all Flower Process Instances for a certain Process Model:
    flowerModel=YOUR-MODEL-KEY AND flowerType in ("Process Instance")
  • Search for all Flower Tasks for a certain Process Model:
    flowerModel=YOUR-MODEL-KEY AND flowerType in (Activity)
  • Search for all Flower Tasks for a certain Process Instance:
  • Search for all Issues related to a certain BPMN activity (node). You can find the BPMN Activity id in the Flower BPMN modeler:

These JQL expressions can be used to create a Jira board or as one of your favorite filters.

Known Issues and development Changelog

Known issues and a detailed changelog of the latest Flower versions can be found here or at the Atlassian Marketplace listing

Try Flower Process Automation for free

Unlock the full power of Jira by aligning and streamlining your BPMN processes and workflows directly with your team: Every business process turns into an automated Jira workflow by creating a Jira issue for each business process activity.