Change record status: 
Project: 
Introduced in branch: 
12.1.x
Introduced in version: 
12.1.0
Description: 

Recipes can now apply recipes that are included with modules, rather than installed as individual recipe packages. For example, in recipe.yml:

recipes:
  # A core recipe
  - core/recipes/page_content_type

  # A recipe located next to this one
  - email_setup

  # A recipe included with the canvas_oauth module, in its recipes/setup directory
  - @canvas_oauth:setup

The idea here is for modules to be able to ship "cookbooks" -- directories of recipes that set up the module in various different, opinionated ways. The recipes in each "cookbook" can only reference each other, or core recipes. The module's recipes must be in a recipes subdirectory (e.g., modules/contrib/webform/recipes).

The @ syntax only works for modules; themes cannot ship recipes this way. The module does not need to be installed, but it does need be in the filesystem.

Impacts: 
Site builders, administrators, editors
Module developers
Site templates, recipes and distribution developers