Skip to main content
Drupal is a registered trademark of Dries Buytaert
Release: OpenID Connect / OAuth client 3.0.0-alpha9 New alpha version released for module openid_connect (3.0.0-alpha9). Usage Milestone: Google Analytics Module google_analytics crossed 1,000 active installs. Release: Timelinr 1.0.1 Minor update available for module timelinr (1.0.1). Release: GraphQL Compose Codegen 1.1.2 Minor update available for module graphql_compose_codegen (1.1.2). Release: Mapy.com 1.1.3 Minor update available for module mapycom (1.1.3). Release: Ckeditor5 entity browser 3.0.3 Minor update available for module ckeditor5_entity_browser (3.0.3). Release: Ckeditor5 entity browser 3.0.1 Minor update available for module ckeditor5_entity_browser (3.0.1). Release: Ckeditor5 entity browser 3.0.2 Minor update available for module ckeditor5_entity_browser (3.0.2). Release: Teamleader Integration 4.0.2 Minor update available for module teamleader (4.0.2). Module Revived: Entityqueue Buttons 1.1.2 Module entityqueue_buttons updated after 8 months of inactivity (1.1.2).

Workflow

5,184 sites Security covered Drupal 8–11 Workflow ecosystem
View on drupal.org

This module allows you to define custom workflows with different states and control how entities can transition between them based on user roles. It can automate actions during transitions, like sending emails or changing content status, and optionally manage content permissions based on workflow state.

This module enables you to create arbitrary Workflows, and assign them to Entities.

Workflows are made up of workflow states. Transitions between states can be allowed per role. For example, a workflow with the states Draft, Review, and Published could be assigned to the Story node type. Only users with role 'chief editor' can set Stories to the published state.
You can set up the Workflow to alter states from form, page, comment, a special block, and a special workflow tab.
Additionally, the submodule Workflow Access allows you to manage view/edit/delete permissions for content types per User role and Workflow state.

Transitions between workflow states can have actions assigned to them. In our example, we could assign an action so that when the story moves from the Draft state to the Review state an email is sent out. Another action could be assigned to the transition from Review to Published so that the node's status is set to Published (and becomes visible on your website).

Documentation resources
A fantastic 45-minutes in-depth Drupal 9 Youtube Instruction video overview is published by saranya ashokkumar.

A - somewhat older - nice overview is published by Michael J. Ross in Drupal Watchdog.
More detailed info can be found at the Workflow documentation page. You can update that page yourself, with anything you have learned when implementing this module.
If you are interested in the future of the workflow module, please join the workflow group on groups.drupal.org.

Developer notes: If you are upgrading your custom, Workflow supporting, module please review the available functions and check the change records.
The D8-version has renamed hooks and function names, to align with D8 practices.
Check the file workflow.api.php for explanation of each hook.

Drupal 8/9/10/11 version
A new and shiny Drupal 8 version is available. The functionality is mostly identical to version 7.x-2.5. Some permissions have been moved to the 'normal' permissions page.

There is still lots to do, and any help is much appreciated. See the list of open tasks or the Kanban Board.

Drupal 7 versions
To find the new features in D7 versions, see the page with New features in D7 version

Related Projects

New D10 add-on modules by Consensus Enterprises:
- Workflow Required by State
- Workflow Save As Draft
- Workflow ECA

  • Workflow Extensions compatible with version 7.x-1.x. Its functionality is incorporated in version 7.x-2.x. Disable when upgrading from 1.x to 2.x.
  • Workflow Fields now compatible with Workflow 7.x-1.2. There is an open issue for compatibility with 7.x-2.x
  • Workflow Named Transitions compatible with version 7.x-1.x. Its functionality is incorporated in version 7.x-2.x. Disable when upgrading from 1.x to 2.x.
  • OG Workflow

Depends on

Dependencies of the latest stable release

  • datetime Drupal core
  • field Drupal core
  • options Drupal core
  • user Drupal core

Required by

1 tracked project depends on this one

Activity

Tracked releases
19
Tracked since
Apr 2025
Latest release
3 days ago
Releases (12 mo)
8 ▼ from 11
Maintenance
Active

Release Timeline

Releases

Version Type Core Release date
2.1.12 Stable 8–11 Aug 28, 2026
6.x-1.0-rc2 Pre-release Jan 5, 2026
2.2.2 Stable 8–11 Jan 5, 2026
2.1.10 Stable 8–11 Jan 5, 2026
2.2.1 Stable 8–11 Dec 1, 2025
2.2.0 Stable 8–11 Dec 1, 2025
2.1.9 Stable 8–11 Nov 1, 2025
2.1.8 Stable 8–11 Oct 30, 2025
2.1.7 Stable 8–11 Aug 29, 2025
2.1.6 Stable 8–11 Jul 25, 2025
2.1.5 Stable 8–11 Jul 17, 2025
2.1.x-dev Dev 8–11 Jul 12, 2025
2.1.4 Stable 8–11 Jul 7, 2025
2.1.3 Stable 8–11 Jul 1, 2025
2.1.2 Stable 8–11 Jun 25, 2025
2.1.1 Stable 8–11 Jun 20, 2025
2.1.0 Stable 8–11 Jun 19, 2025
2.0.x-dev Dev 8–11 Jun 19, 2025
2.0.0 Stable 8–11 Apr 18, 2025