Skip to main content

Flowable Hub User Guide

Introduction

Flowable Hub is the management application in Flowable Cloud. The platform is divided into two core areas:

  • Management: Configure users, groups, and application permissions to ensure the right people have the right access.

  • Environment: Monitor and control runtime environments, deploy new apps and investigate runtime or historical data for your tenant.

In the future, Hub will supersede Flowable Control for on-premise deployments, too.

Management

The Management section of Flowable Hub allows to configure who can do what across the various environments. New users can be onboarded, permissions can be added or removed, assign roles, manage group memberships, and define privileges.

In addition to access control, Management also provides real-time visibility into the applications deployed within your environment. This means you always know what’s running, where, and who has access.

Applications

To fully leverage Flowable Hub’s permissions management, it helps to first understand how an environment is structured. Flowable Cloud is organized into three key application:

  • Work – where runtime execution and task management takes place.

  • Design – where models and definitions are created.

  • Hub – administrative insight and configuration.

Work is available in both Production and Sandbox environments. Design is configured to be able to publish to each environment, allowing you to test out models in the sandbox environment before promoting it to the production environment.

These applications are listed in the permissions interface, allowing you to assign access across one or more environments.

A view of the applications tab

Users

Through the User menu, you can add, edit, or remove users—giving you full control over who can access your environment and what they can do.

Each user profile includes identity fields such as First Name, Last Name, Display Name, and Email or External ID, making it easy to manage access across teams and roles.

Filtering

Flowable Hub makes it easy to find exactly who you're looking for. At the top of the User Management screen, you'll find a filtering bar that lets you quickly narrow down the list based on user attributes.

the user list filtering

Just below the filter, you'll see a complete list of users currently registered:

the user list display

Create User

To add a new user, simply click the Create User button located to the right of the filtering bar.

create user button

The user creation form allows you to enter key details such as First Name, Last Name, Display Name, and Email or External ID. You can also assign roles across the Work, Design, and Hub applications—ensuring each user has the right level of access from the start.

create user screen

Edit/Delete User Profile

Managing user access is just as easy as creating it. From the user list, you can quickly edit user details or remove users entirely.

User dropdown menu

User edit screen

User Details

Clicking on a user record opens a detailed User Profile view, giving you full visibility into the user's identity and their access across applications. From this screen, you can easily edit user details, adjust roles, or remove access.

You’ll also see which applications the user has access to, making it simple to manage permissions and ensure alignment with their responsibilities.

User details view

Managing Application Access

Flowable Hub gives you precise control over user access across different applications. From the User Profile screen, select the relevant application tab — Work, Design, or Hub — and you’ll unlock a set of options to manage:

  • User roles
  • Group memberships
  • Assigned privileges

This interface allows tailor access based on responsibilities, ensuring users have exactly the permissions they need.

User application access details

User Roles

The User Roles section provides a view of all roles available within Flowable Hub. These roles define what users can do across different applications and can be assigned during user creation or updated later as responsibilities evolve.

User roles screen

To see which users are assigned to a specific role within an application, simply click on the role in the User Roles section. Each application — Work, Design, and Hub — has its own tab, allowing to review role assignments across environments.

User role details screen

Groups

With groups, users can be organized to streamline permission management. Through the Group menu, you can create, edit, or remove groups to reflect team structures and operational needs.

Each group is defined by a Name, Group Key, and Group Type.

Filtering

At the top of the Group Management screen, you’ll find a filter bar that lets you quickly search by group name—helping you locate and manage specific groups quickly.

This feature is especially useful in complex environments where multiple teams or roles are organized into distinct groups.

the group list filtering

A list of groups will be found underneath the filter.

the group list

Create Group

To create a new group, click the Create Group button located to the right of the filtering bar.

Create group button

This action opens a form where you can define the group’s Name, Group Key, and Group Type—giving control over how users are organized and how permissions are applied across your environment.

Create group screen

Edit/Delete Group Profile

From the Group list, you can easily edit or delete any group using the dropdown menu located to the right of each entry.

group dropdown menu

edit group screen

Group Details

Clicking on a group entry opens the Group Profile view, where you can see all the privileges assigned to that group. From this screen, you can also edit group details or delete the group entirely.

This view allows to check group permissions and adjust access as team roles evolve.

group details screen

To see which users belong to a specific group, navigate to the application tab relevant to your review — Work, Design, or Hub. Each tab displays the group’s members within that context, making it easy to understand how access is structured across different parts of the platform.

Privileges in Hub

Flowable Hub offers a flexible and granular permissions model, allowing you to tailor access based on user roles and responsibilities across the platform. Permissions are grouped into three main categories: Design, System, and Work.

Design Privileges

  • Create Design Workspace: Grants the ability to create new design workspaces for modeling applications.
  • Plugin Management: Allows access to manage and configure plugins within the design environment.
  • Publish to Work Production: Enables publishing of applications directly to the Work Production environment.

System Privileges

  • Actuator Endpoints: Provides access to system-level actuator endpoints for monitoring and diagnostics.
  • Admin: Grants full administrative rights across the platform.

Work Privileges

  • Change Own Theme: Allows users to personalize their interface by changing their theme.
  • Create Work: Enables access to the “Create Work” functionality within the Work application.
  • Disable Data Table Filters: Controls whether data table filters are enabled or disabled for the user.
  • Edit Own Avatar: Lets users update their profile avatar.
  • Personal Access Tokens: Grants permission to generate personal access tokens for API authentication.

Assigning Privileges

To assign privileges to a group, click the “Assign Privileges” button from the Group Profile screen.

Privilege assignment screen

Deleting Privileges

To remove a privilege from a group, click the trashcan icon next to the privilege in the list.

privilege trashcan location

Environment

The Environment section gives you sinsight and control over the live runtime artifacts of your Flowable setup.

Apps

In Flowable, applications are deployed directly to the runtime environment. The Apps page offers real-time view of all deployed applications, giving you insight into what’s running across your environment.

app list screen

Work

Each application is powered by a set of models that are transformed into definitions at runtime. Fro these definitions, the execution engine start new instances. The Work section of Flowable Hub gives visibility and control over these definitions and their corresponding instances.

Work Instances

The Work Instances view offers a real-time snapshot of all active process and case instances running in the environment. Process and case definitions are differentiatied using icons and ID prefixes (PRC for process, CAS for case). To see more details, click on the entry.

work instances screen

Instance Management

Instance Management in Flowable Hub gives you operational control over every running and completed instance, whether BPMN or CMMN. Active instances offer a rich set of actions—from suspending and migrating to inspecting variables and tasks—allowing to intervene and optimize in real time. Completed instances retain essential metadata for auditing and analysis, ensuring transparency across the lifecycle. With tabs for variables, tasks, subprocesses, jobs, events, decisions, and more, you get a comprehensive view of each instance’s journey.

instance management screen

Details

The Details tab provides an overview of the instance’s metadata—including key identifiers, status, and timestamps. From here, you can also navigate directly to the associated definition, making it easy to trace execution back to its design.

instance details tab

Variables

The Variables tab gives you access to all runtime variables associated with the instance. The “Local Variables” toggle lets you filter for variables scoped to specific tasks, executions or plan item instances.

instance variables tab

Tasks

The Tasks tab presents a list of all tasks associated with the selected instance. With a click, you can open any task to explore its details, manage assignments, and execute actions.

instance tasks tab

Sub Processes

The Sub Processes tab shows any nested process instance linked to the current instance. Clicking on the entry will show the details of the sub process.

instance sub-processes tab

Jobs

The Jobs tab displays all pending jobs associated with the instance, categorized into Executable, Timer, Suspended, Deadletter, and History.

instance jobs tab

Events

This tab shows runtime events, modeled for example with event listeners in CMMN or intermediate catch events in BPMN currently associated with the instance.

instance events tab

Decisions

The Decisions tab showcases all decision logic executed during the instance. Click into any decision to view its details and outcomes.

instance decisions tab

Execution

Get a granular view of the instance’s execution paths with the Execution tab. This detailed breakdown helps you understand what is occuring through the instance, supporting advanced troubleshooting.

instance execution tab

Form Instances

The Form Instances tab lists all forms tied to the process. Clicking on a form opens a detailed pane, allowing you to review submitted data and ensure user interactions are captured accurately.

instance form instances tab

instance form details tab

Activities

The Activities tab provides a snapshot of all runtime activities within the instance, helping you trace execution.

instance activities tab

Model Hierarchy

This view outlines how the current instance fits into the broader instance hierarchy.

For example, in a case instance, it displays its child elements—such as tasks, subprocess instances, and other components—giving you full visibility into how execution is organized and nested.

instance model hierarchy tab

Actions

The Actions tab provides a comprehensive view of all action instances that have occurred.

instance actions tab

Work Definitions

Definitions are the blueprint behind every running instance in Flowable. Each time you deploy a model update, a new version of the definition is created—ensuring your processes evolve without disrupting operations. The Definitions tab gives an overview of all available versions within the runtime environment. By default, it highlights the latest version, but you can easily toggle to view historical revisions.

instance work definitions tab

Clicking into a definition opens a detailed view where you can explore version history, inspect metadata, and trace active instances tied to that definition. Additional tabs provide access to related jobs and model hierarchy.

instance details tab

Within the definition detail view, a version selector in the top-right corner allows you to navigate between different iterations of the model—making it easy to track changes over time. The lower half of the screen features four key tabs:

Details

View essential metadata for the selected model, including versioning, deployment info, and identifiers.

definition details

Instances

Explore a list of all running and completed instances tied to the definition. Clicking an entry takes you directly to the corresponding Work Instances view for deeper inspection.

definition instances

Jobs

Monitor background jobs associated with the definition, helping you stay ahead of potential execution issues.

definition jobs

Model Hierarchy

Visualize how the current definition fits into the broader hierarchy, including any linked subprocesses or reusable components.

definition hierarchy

Changing Process State (Token Move)

In the Instance View, you can interact directly with flow nodes within the diagram. By selecting both a source node and a destination node, the Change Process State button becomes available.

If the selected source node contains a token, that token will be moved to the destination node you chose.

  • Order of selection does not matter.
  • If no token is present at the selected source node, no action will occur.

token selection

Once you click Change Process State, a confirmation modal will appear.
Click Confirm to execute the token move. token move confirmation

Instance Migration Walkthrough

Flowable Hub makes it easy to migrate individual instances to a new definition version—without disrupting execution. Here’s how the process works:

  1. Access the Instance Detail View
    Navigate to Work > Instances and select the instance you want to migrate. From the detail screen, click the Migrate Instance button. instance details screen
  2. Select Target Definition
    A migration screen will appear, allowing you to choose the target definition version. You can migrate to a newer version—or even revert to an older one—depending on your needs. Migrate instance definition selection
  3. Map Execution Steps
    Click Go to Mapping to define how tokens should transition between the current and target definitions. Select a step from the left (current version) and a corresponding step from the right (target version), then click Add to Map to create the mapping. map execution steps screen
  4. Review and Execute
    Once all necessary mappings are defined, click Execute Migration to apply the changes. Confirm in the modal that pops up and the instance will now reflect the new definition, with tokens repositioned according to your mappings. execute merge screen
Definition Migration

In addition to migrating individual instances, Flowable Hub allows you to upgrade all instances tied to a specific definition—streamlining bulk updates across your environment.

From the Definitions screen, simply click the Migrate Definition Instances button. This launches the same migration interface used for single-instance migration, allowing you to select a target version and define token mappings.

Once mappings are confirmed, executing the migration will update all instances associated with the selected definition—ensuring consistency and reducing manual overhead. This feature is especially useful for large-scale deployments or when rolling out updates across multiple workflows.

Decisions

The Decisions tab provides a clear view of all DMN based decision logic executed within your environment.

decisions list

Clicking on a decision opens the details on the specific execution of the DMN execution:

decision details view

Tasks

The Tasks tab gives visibility into both active and completed tasks. Active tasks come with a set of management options—including update, assign, delegate, and complete—allowing you to take direct action when needed.

Each task includes tabs for:

  • Details: View task metadata such as name, description, assignee, due date, and priority.
  • Sub Tasks: See any child tasks linked to the main task.
  • Identity Links: Review all users and groups associated with the task.

task details view

Updating Tasks

The Update button lets you modify key task details—including name, description, assignee, owner, due date, priority, and category/

task update screen

Assign / Claim Tasks

The Assign or Claim button allows users to take control of a task or assign it to another team member.

task assign screen

Delegate

Reassign tasks without losing visibility. Use the Delegate button to pass a task to another user while maintaining the task owner.

task delegate screen

Complete

Clicking the Complete button triggers a confirmation prompt, allowing you to finalize a task once all required actions are taken.

task complete screen

Jobs

The Jobs tab gives you a view of all asynchrounous background jobs running within your Flowable environment. Jobs are categorized into five types: Executable, Timer, Suspended, Deadletter, and History.

task jobs view

Clicking on a job entry opens a detailed view where you can explore key metadata associated with the job. This includes fields such as Due Date, Created Timestamp, Instance ID, Execution ID, Element ID and Name, Remaining Retries, Definition Reference, Lock Owner, Lock Expiration Time, and Tenant Context. You are able to move, reschedule, or delete a job from this view.

task job details

Incidents

The Incidents tab provides an overview of all execution issues across your environment. Whether it's a failed job, an unhandled exception, or a process that didn’t behave as expected, incidents are logged here for tracking and resolution.

task incidents list

Clicking on an incident opens a detailed view, allowing you to investigate root causes, review related metadata, and take corrective action.

task incident details

Dashboard

The Dashboard section offers various visual charts that give insight into the environment.

dashboard menu options

Running Instances

This chart shows the number of active instances currently being executed across the environment. It helps you monitor throughput, detect spikes in activity, and ensure your workflows are performing as expected.

running instances dashboard

Completed Instances

This chart shows metrics around process and case instances that were completed.

completed instances dashboard

Jobs

These chart can be used to monitor background activity and system load. It displays the volume and status of jobs—such as timers, asynchronous tasks, and retries.

jobs dashboard

Service Registry Executions

This dashboard view highlights executions involving external services, giving insight into how external systems are being called and how frequently. It’s especially useful for tracking integration health and responsiveness.

service registry dashboard

Active Users

This chart gives an overview of active users within the environment.

active users dashboard

OAuth2 Clients

The OAuth2 Clients section allows you to configure trusted clients for authentication and API access. New clients can be added, scopes defined, and credentials set.

oauth2 clients list

Clicking “Add OAuth2 Client” opens a guided form where you can enter client details, and configure access tokens.

oauth2 client create

Secrets

Secure sensitive data with built-in secret management. The Secrets section in Flowable Hub allows you to store and manage environment secrets—such as API keys, tokens, and credentials—safely and efficiently. You can add new secrets manually or generate them automatically, with options to view or copy values before final confirmation.

To create a new secret, click Add Secret. secrets list On the resulting screen enter your value (or generate one), and confirm. For security, Flowable only displays the secret once during creation—ensuring it remains protected. add secrets screen To update a secret, simply delete and recreate it. The trashcan icon allows for quick removal, with a confirmation prompt to prevent accidental deletion. delete secret confirmation

Glossary of Terms

Actuator Endpoints
System-level endpoints used for monitoring and diagnostics.

Case Instance (CAS)
A running instance of a case model, used to manage non-linear or event-driven workflows.

Dashboard
A visual interface in Flowable Hub that provides real-time metrics and operational insights across the automation environment.

Definition
A deployed model that serves as the blueprint for process or case execution.

DMN (Decision Model and Notation)
A standard for modeling decision logic, used in Flowable to define business rules.

Environment
The runtime section of Flowable Hub where deployed applications, instances, and system artifacts are monitored and managed.

Group
A collection of users organized by role, function, or team, used to simplify permission management.

Instance Migration
The process of transitioning running process or case instances to a new version of their definition.

Job
A background task in Flowable, such as timers or retries, categorized into Executable, Timer, Suspended, Deadletter, and History.

Model Hierarchy
A visual representation of how a process or case model fits into the broader design structure, including linked subprocesses.

OAuth2 Client
An external application or service configured to authenticate and interact with Flowable via secure API access.

Personal Access Token
A user-generated token used for authenticating API requests securely.

Process Instance (PRC)
A running instance of a process model.

Privilege
A specific permission granted to users or groups, defining what actions they can perform within Flowable applications.

Role
A predefined set of privileges assigned to users or groups to control access and capabilities.

Sandbox Environment
A non-production environment used for testing and experimentation without affecting live operations.

Secret
Sensitive data such as API keys or credentials stored securely within Flowable Hub.

Subprocess
A nested process or case within a larger workflow, used to modularize and reuse logic.

Task
A unit of work within a process or case, which can be assigned, delegated, or completed by users.

Token Mapping
The process of aligning execution steps between old and new definitions during instance migration.

User Profile
A record containing identity and access information for a Flowable user.

Work
The Flowable application responsible for executing and managing tasks, processes, and cases.