Skip to Content
Flower 3.7.1 is released 🎉 See what's new
Developer Reference· 3 min read· Updated November 2026

Search Flower Data with JQL

Flower stores all its data as Jira work items: models, process instances, and activities (the tasks of a process) are all work items.
So you can search, filter, and track them with JQL (Jira Query Language) like any other work item. For example, you can:

  • Find all BPMN models in Jira.
  • Monitor running process instances and their progress.
  • Track activities and their assignments.

To try a query, open the advanced search in Jira, switch to JQL, and enter the query:

Flower JQL Advanced Search

Flower Search Fields

Flower adds the following fields to JQL:

FieldContainsExample
flowerTypeThe kind of Flower entity: Model, "Process Instance", or ActivityflowerType = Activity
flowerModelThe key of the modelflowerModel = YOUR-MODEL-KEY
flowerInstanceThe key of the process instance an activity belongs to. Also set on a sub-process instance: it names the calling process instanceflowerInstance = YOUR-INSTANCE-KEY
flowerLaneThe name of the swimlane of an activityflowerLane = "YOUR-LANE-NAME"
flowerNodeThe ID of the BPMN activity in the model. You find it in the Flower BPMN modeler.flowerNode = YOUR-ACTIVITY-ID
flowerTimerA date: the due day of the timer of an activity, or of the earliest waiting timer of a process instance (intermediate timer, timer start event, timer on a sub-process). Empty when no timer waits, see Timer EventsflowerTimer <= endOfWeek()
flowerSignalThe names of the signals a process instance waits for now, normalized: upper case, without accents and apostrophes, -, _ and several spaces as one space (Won’t Do is WONT DO). Empty when it waits for none, see Signal EventsflowerSignal = "PRICE LIST CHANGED"
flowerVersionThe version number of the model: on a model its current version, on a process instance and its activities the version of the model they runflowerVersion = 3
flowerParentOn an activity the key of its process instance, on a process instance the key of its modelflowerParent = YOUR-INSTANCE-KEY
flowerNext, flowerPreviousThe IDs of the following and preceding tasks of an activity in the model (not in Data Center)flowerPrevious = YOUR-ACTIVITY-ID

You can combine them with Jira’s standard fields, for example resolution is EMPTY to find only open work.

Two more fields are defined but not meant for searches: flowerActivity (always empty) and flowerMigration (reserved for the move from Connect to Forge, not written by Flower, not in Data Center).

Common Queries

Find Flower Entities

GoalJQL
All Flower entitiesflowerType in (Model, "Process Instance", Activity)
All process modelsflowerType = Model
All process instancesflowerType = "Process Instance"
All activities (call activities run as sub-processes and are process instances, see Sub-Processes)flowerType = Activity

Narrow Down by Model, Instance, Swimlane, or Activity

GoalJQL
All process instances of a modelflowerModel = YOUR-MODEL-KEY AND flowerType = "Process Instance"
All activities of a modelflowerModel = YOUR-MODEL-KEY AND flowerType = Activity
All activities of a process instance, including its sub-processesflowerInstance = YOUR-INSTANCE-KEY
All sub-processes of a process instanceflowerType = "Process Instance" AND flowerInstance = YOUR-INSTANCE-KEY
All sub-processes in totalflowerType = "Process Instance" AND flowerNode IS NOT EMPTY
All activities of a swimlaneflowerLane = "YOUR-LANE-NAME"
All work items of one BPMN activity, across all process instancesflowerNode = YOUR-ACTIVITY-ID

Find Open Work Only

GoalJQL
Running process instances (including running sub-processes)flowerType = "Process Instance" AND resolution is EMPTY
Running process instances without sub-processesflowerType = "Process Instance" AND flowerNode IS EMPTY AND resolution is EMPTY
Open activities of a swimlaneflowerLane = "YOUR-LANE-NAME" AND resolution is EMPTY
Open activities of a modelflowerModel = YOUR-MODEL-KEY AND flowerType = Activity AND resolution is EMPTY

Find Activities with a Due Timer

This query finds all open activities with a timer that is due today or overdue.
It is also available as Timer Filter in the Flower Settings. Learn more in The Timer Job.

flowerType = Activity AND Resolution IS EMPTY AND flowerTimer IS NOT EMPTY AND (duedate <= endOfDay() OR duedate IS EMPTY AND flowerTimer <= endOfDay())

Use Your Queries

  • Save a query as a filter and mark it as a favorite to find it again quickly.
  • Use a filter for a Jira board to manage your processes visually. See how to configure the filter of a board .
  • Build dashboards and reports on your filters to monitor and improve your processes.

With JQL, your process models, process instances, and activities are always searchable, trackable, and actionable in Jira.

What’s Next?

Last updated on