Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Recipe Ops

Security covered Under active development

Part of the Recipe ecosystem · 9 projects

Recipe Ops enhances Drupal's recipe functionality by adding a planning phase before applying recipes, a confirmation step during application, and the ability to revert changes afterward. It provides Drush commands to preview recipe impacts, apply them safely with rollbacks, and revert them using configuration checkpoints.

Recipe Ops adds the workflow Drupal recipes are missing: a plan before you apply, a checkpoint while you apply, and a revert afterwards.

Drupal recipes are "apply once and forget". There is no preview of what a recipe will change and no way to undo it once applied (see #3333076: Support reverting a recipe). Recipe Ops wraps core's Recipe API with a small set of Drush 13 commands and an audit report.

Commands

  • drush recipe-ops:plan RECIPE — lists the modules, themes, configuration, config actions, content and inputs a recipe and its dependencies would touch. Changes nothing. --format=json for CI and review.
  • drush recipe-ops:apply RECIPE — shows the plan, asks for confirmation, takes a core configuration checkpoint, applies the recipe, and records exactly what was installed and created. A recipe that throws part-way is rolled back automatically.
  • drush recipe-ops:revert ID — previews the exact configuration changes and content deletions, then deletes the content the recipe created and restores the checkpoint through the standard configuration importer, which also uninstalls the modules the recipe installed.
  • drush recipe-ops:list and drush recipe-ops:show ID — history of every application, also available at Reports → Recipe applications.

Safety model

Core configuration checkpoints form a linear history: restoring an older checkpoint also undoes everything applied after it. Recipe Ops therefore refuses to revert an application while newer ones are still in effect unless you pass --cascade, which reverts them newest-first, and it always prints the full list of configuration objects and content entities that will change before asking for confirmation.

Requirements

  • Drupal 11.1 or later
  • Drush 13 for the commands (the module installs without Drush, but the workflow is command-line first)

Stability

Recipe Ops builds on core's Recipe and checkpoint APIs, which core still marks as experimental. The module pins drupal/core: ^11.1 and runs its test suite (unit, kernel and functional) against the next major release in GitLab CI so breaking changes surface early. Feedback and use cases from people maintaining site templates are especially welcome in the issue queue.

Drupal 11 · not 10 PHP 8.3

Ask your assistant about Recipe Ops

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
Sep 2026
Latest release
2 weeks ago
Releases (12 mo)
3 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.0 Stable 11 PHP 8.3 Oct 26, 2026
1.0.0-alpha2 Pre-release 11 PHP 8.3 Sep 30, 2026
1.0.0-alpha1 Pre-release 11 PHP 8.3 Sep 30, 2026