Install

Works with Drupal: ^11.4 || ^12

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 258.92 KB
MD5: 04d801ce76af658157976de917301db4
SHA-1: ba4de7ec2a124f8ef2030cedb073099dd8fb9eef
SHA-256: afb71da8033c0ee1a5b7fe93cbf8a4b6948f2d123f5db518c938f5b812b8805c
Download zip 385.05 KB
MD5: 3a2f3976aa5bdb80240263735669c531
SHA-1: 4ba549b6ac0163ef046bbce69ae69bee7f7ca97a
SHA-256: e0e20bd5b27d6b5b13491c86d686815fee24c053848256c74a7f08f82aee75fe

Release notes

First release of Workspace Config. It stages configuration changes in a workspace, the same way as content, and publishes them to Live together with the content that needs them.

Requirements

  • Drupal 11.4 or later, with the core Workspaces module.
  • Optional: Workspaces Extra (WSE) 3.0.0-alpha6 or later, to revert a published workspace, configuration included.
  • Optional: Workspace Menu, to change menu links inside a workspace.

What stages

  • Content types, fields and field storages, form and view displays, display modes, views, blocks, menus, text formats and editors, date formats, actions, comment types, REST resources and languages.
  • More than 20 core settings objects, such as the site information, theme, performance, date, user and Views settings. A few keys stay Live-only, for example the site timezone.
  • Configuration translations, language negotiation and language types.
  • From contributed modules: Canvas, contact forms and Pathauto patterns.
  • Pages that come from staged config, such as a new page view, work inside the workspace before publishing.

Keeping Live safe

  • Configuration that is not marked as stageable can't be changed inside a workspace. Its forms only save in Live.
  • Publishing imports the staged configuration with the full config import validation. If the import or the content publish fails, the Live configuration is rolled back and the workspace keeps its changes.
  • Publishing logs a warning for configuration that Live changed after the workspace started staging it.

For module developers

  • Make your configuration stageable with the WorkspaceSafe or WorkspaceIgnored schema constraints, or with hook_workspace_config_safe_list_alter() and hook_workspace_config_ignored_list_alter().
  • Keep single keys in Live with the ConfigLiveOnlyKeys constraint.
  • Tag services that cache configuration with workspace_config.reset, so they are reset on a workspace switch.

See Making your config stageable.

Known limitations

The full list is in Limitations.

Created by: amateescu
Created on: 6 Oct 2026 at 21:01 UTC
Last updated: 6 Oct 2026 at 21:01 UTC
Bug fixes
New features

Other releases