FlowDrop is a visual, code-free module for orchestrating workflows in Drupal. It allows you to create, manage, and track complex processes that integrate with your existing Drupal content and users, providing explicit data flow and a full audit trail for predictable automation.
Workflow Orchestration for Modern Drupal FlowDrop is the workflow orchestration module for Drupal. It gives you everything you need to create, manage, run, and track flows — and more capabilities are added as the orchestration story grows. Visual, code-free, and fully integrated with the entities, users, and content you already have.
Where simple event-driven automation hides data flow behind tokens, FlowDrop makes every connection explicit: typed ports, visible edges, traceable executions. The graph is the specification, the execution engine, and the audit trail in one.
📖 FlowDrop Guide
FlowDrop's mission is to provide the orchestration layer improvements in Drupal. Please try it out FlowDrop's Documentation and provide feedback. Lets improve it together!
See more details:
FlowDrop Documentation
Why FlowDrop?
- Predictable over autonomous: Pre-defined workflow graphs produce reproducible, inspectable results. Unlike black-box agents, you know exactly what will happen at each step.
- AI-ready, not AI-dependent: Integrate LLMs (OpenAI, Mistral, and others) as steps within controlled workflows. AI is a tool in your pipeline, not an unsupervised decision-maker.
- Full audit trail: Every workflow execution creates persistent records: pipeline status, job inputs/outputs, session messages, and human approvals. Query and inspect execution history at any time.
- Drupal-native: Built on Drupal's entity system, plugin architecture, and configuration management. Works with your existing content, users, and infrastructure.
Key Features
- Visual Workflow Editor: Drag-and-drop graph editor (inspired by tools like n8n and Langflow) with typed ports, colour-coded data types and visible edges. Every connection is explicit, so the graph is the specification.
- 65+ Built-in Nodes: Data transformation and dataframes, control flow and gateways, entity queries and saves, HTTP requests, text and markdown processing, AI prompting and tool calling, and more.
- Workflows Are Configuration: Workflows are standard Drupal config entities, so they export to YAML, version in git, and deploy across dev, stage and prod with
drush cex/cim. - Three Execution Modes:
- Synchronous (in-request),
- Asynchronous (queue-based background), and,
- StateGraph, which gives you checkpointed, resumable execution for chat, loops and long-running flows.
- Execution Tracking: Every run produces a pipeline record with one job per node: what ran, what data went in, what came out, how long it took, what failed. Real-time monitoring and per-node inspection in the admin UI.
- Human-in-the-Loop: Pause workflows for confirmations, choices, forms or free-text input, with a complete record of who approved what and when.
- Agent Foundations: Sessions, scoped memory and tool-calling nodes give workflows the state and context that conversational agents need.
- Event-Driven Triggers: Execute workflows automatically on entity changes, user events, cron schedules, or external invocation.
- Nested Workflows: Compose complex automation by calling workflows from within other workflows.
- Site-Builder Extensible: Node Types and Node Categories let you configure pre-set node variants and organise the editor palette without touching code.
- Developer Extensible: Create custom node processors, triggers and orchestrators as PHP plugins, with a documented BC policy for the public API.
- Secrets Kept Out of Config: With the Key module,
${{ secrets.NAME }}references resolve at runtime, so credentials never land in workflow config or job records.
Companion Modules
FlowDrop's node palette grows with the modules you already run. Each companion module brings its connectors onto the canvas automatically, with no glue code.
- FlowDrop AI Provider: Bridges FlowDrop to the AI and AI Agents modules, adding nodes for chat, embeddings, moderation, translation, speech, image and video operations. Every model from every configured AI provider (OpenAI, Anthropic, Mistral, Ollama and the rest) becomes available to your workflows.
- FlowDrop Tool Provider: A two-way bridge to Drupal's Tool API. Every Tool API tool appears automatically as a FlowDrop node, and any FlowDrop workflow can be published back as a tool with a typed input and output contract, callable by ECA, Maestro, AI agents, or anything else that speaks Tool API.
- Orchestration: Exposes FlowDrop workflows to external automation platforms.
Requirements
- Drupal 11.2 or higher
- PHP 8.2 or higher
Related Modules
Explore complementary components that extend FlowDrop’s capabilities, from AI integrations to intelligent workflow automation.
- FlowDrop Agents - AI agent capabilities for FlowDrop workflows
- FlowDrop Field Widget Actions - Triggers FlowDrop workflows using field widget actions integration
- FlowDrop Gin - Gin admin theme integration
Resources
Access helpful materials, documentation, and tools to get the most out of FlowDrop.
Contributing
The FlowDrop module's issue queue is intended for reporting bugs, submitting feature requests, and planning.
Additionally, you can join the #flowdrop channel on Drupal Slack.
Feedback are encouraged, but please expect rapid iteration and breaking changes as the project stabilises.
Brought to you by
Depends on
Dependencies of the latest stable release
- FlowDrop flowdrop_ui_components
Required by
8 tracked projects depend on this one
- FlowDrop 339 sites
- FlowDrop AI Provider 9 sites
- FlowDrop UI Agents 8 sites
- FlowDrop FWA 6 sites
- FlowDrop Agents 3 sites
- FlowDrop Gin 3 sites
- FlowDrop AI Context (CCC) 2 sites
- FlowDrop AI Search
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 2.5.0 | Stable | 11 | Find and Replace, and a regex guard that was switched off on some hosts. | Aug 30, 2026 | |
| 2.4.2 | Stable | 11 | Approval prompts you can actually answer | Aug 27, 2026 | |
| 2.4.1 | Stable | 11 | A rule-conformance patch | Aug 27, 2026 | |
| 2.4.0 | Stable | 11 | Name what a port carries | Aug 23, 2026 | |
| 2.3.0 | Stable | 11 | Loops you can trust, Better building blocks for agents and chat | Aug 18, 2026 | |
| 2.3.0-alpha5 | Pre-release | 11 | Improve test coverage and DX | Aug 16, 2026 | |
| 2.3.0-alpha4 | Pre-release | 11 | Aug 15, 2026 | ||
| 2.3.0-alpha3 | Pre-release | 11 | Aug 15, 2026 | ||
| 2.3.0-alpha2 | Pre-release | 11 | At-most-once tool execution | Aug 15, 2026 | |
| 2.3.0-alpha1 | Pre-release | 11 | Agent loops stop being a three-node privilege, and a message list stops being "an array" | Aug 14, 2026 | |
| 2.2.0 | Stable | 11 | Confirmation becomes governance. | Aug 9, 2026 | |
| 2.1.0 | Stable | 11 | Confirmation Gate improvements | Aug 9, 2026 | |
| 2.0.0 | Stable | 11 | Aug 4, 2026 | ||
| 2.0.0-beta1 | Pre-release | 11 | Aug 4, 2026 | ||
| 2.0.0-alpha15 | Pre-release | 11 | orchestration_connector now can do the full loop | Aug 2, 2026 | |
| 2.0.0-alpha14 | Pre-release | 11 | Aug 1, 2026 | ||
| 2.0.0-alpha13 | Pre-release | 11 | Credentials stop being stored in workflow config and contract hardening | Jul 31, 2026 | |
| 2.0.0-alpha12 | Pre-release | 11 | Hardening release | Jul 27, 2026 | |
| 2.0.0-alpha11 | Pre-release | 11 | Consolidates workflow routing onto one mechanism | Jul 26, 2026 | |
| 2.0.0-alpha10 | Pre-release | 11 | Bugfix release. Fixes a fresh-install defect on flowdrop_pipeline, | Jul 23, 2026 | |
| 2.0.0-alpha9 | Pre-release | 11 | Jul 22, 2026 | ||
| 2.0.0-alpha8 | Pre-release | 11 | Node config opens in a modal; console / AI Assistant dock in the right sidebar | Jul 22, 2026 | |
| 2.0.0-alpha7 | Pre-release | 11 | Data-wired inputs on tool nodes | Jul 21, 2026 | |
| 2.0.0-alpha6 | Pre-release | 11 | Adds the pieces to author an agent loop as a graph | Jul 10, 2026 | |
| 2.0.0-alpha5 | Pre-release | 11 | Follow up on 2.0.0-alpha4 | Jul 7, 2026 | |
| 2.0.0-alpha4 | Pre-release | 11 | Hardening release. Non json_encode-able data fails loudly at execution time instead of silently corrupting to an empty object once persisted | Jul 7, 2026 | |
| 2.0.0-alpha3 | Pre-release | 11 | Central logging settings now govern all runtime execution logging. | Jul 7, 2026 | |
| 2.0.0-alpha2 | Pre-release | 11 | Fix regressions introduced by the 2.0.0 node-metadata slimming | Jul 6, 2026 | |
| 2.0.0-alpha1 | Pre-release | 11 | failure-aware runs, Workflow Doctor, signed bundle transport and BREAKING BAD! | Jul 2, 2026 | |
| 2.x-dev | Dev | 11 | Cleanup deprecated code in 1.x and build for stability | Jul 2, 2026 | |
| 1.6.0 | Stable | 11 | Playground improvements | Jul 1, 2026 | |
| 1.5.0 | Stable | 11 | May 27, 2026 | ||
| 1.4.1 | Stable | 11 | flowdrop_pipeline installs standalone again | May 24, 2026 | |
| 1.4.0 | Stable | 11 | Typed workflow I/O | May 24, 2026 | |
| 1.3.0 | Stable | 11 | Apr 28, 2026 | ||
| 1.2.1 | Stable | 11 | Apr 5, 2026 | ||
| 1.2.x-dev | Dev | 11 | Mar 19, 2026 | ||
| 1.1.x-dev | Dev | 11 | Mar 19, 2026 | ||
| 1.2.0 | Stable | 11 | Mar 19, 2026 | ||
| 1.1.2 | Stable | 11 | Mar 18, 2026 | ||
| 1.1.1 | Stable | 11 | Mar 17, 2026 | ||
| 1.1.0 | Stable | 11 | Memory support, FlowDrop workflow remembers! | Mar 16, 2026 | |
| 1.0.0 | Stable | 11 | Mar 7, 2026 | ||
| 1.0.0-beta2 | Pre-release | 11 | Mar 7, 2026 | ||
| 1.0.0-beta1 | Pre-release | 11 | FlowDrop is now feature-complete for 1.0 and entering stabilization | Feb 27, 2026 | |
| 1.0.0-alpha5 | Pre-release | 11 | Typed event system | Feb 26, 2026 | |
| 1.0.0-alpha4 | Pre-release | 11 | Standardize API | Feb 21, 2026 | |
| 1.0.0-alpha3 | Pre-release | 11 | Resolving circular dependencies in the project | Feb 21, 2026 | |
| 1.0.0-alpha2 | Pre-release | 11 | Permission adjustments | Feb 7, 2026 | |
| 1.0.0-alpha1 | Pre-release | 11 | This is the first alpha release toward a stable 1.0 | Feb 7, 2026 |