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 | |
|---|---|---|---|---|---|
| 0.6.0 | Stable | 11 | UI and Orchestration Overhaul | Feb 5, 2026 | |
| 0.5.1 | Stable | 11 | Playground improvements | Jan 27, 2026 | |
| 0.5.0 | Stable | 11 | Human In Loop Interrupts | Jan 26, 2026 | |
| 0.4.3 | Stable | 11 | Fixed issues with Orchestrator discovery | Jan 17, 2026 | |
| 0.4.2 | Stable | 11 | Use a Iconpicker for icons | Jan 17, 2026 | |
| 0.4.1 | Stable | 11 | Fixes a serialization error which broke ajax requests | Jan 16, 2026 | |
| 0.4.0 | Stable | 11 | Removed `execute()` method from NodeProcessorInterface in favor of the clearer `process()` method | Jan 15, 2026 | |
| 0.3.0 | Stable | 11 | Visual improvements on jobs and pipeline details | Jan 13, 2026 | |
| 0.2.0 | Stable | 11 | Introduced support for Events/Triggers | Jan 12, 2026 | |
| 0.1.0 | Stable | 11 | Initial tagged release | Jan 10, 2026 | |
| 1.x-dev | Dev | 11 | Initial release for testing waters | Aug 21, 2025 |