
Sur la plupart des sites Drupal, le workflow éditorial s’arrête à l’échelle d’un contenu : un brouillon, une relecture, une publication. Content Moderation fait ça très bien.
Le problème arrive quand le changement ne tient pas dans un seul contenu. Une campagne, c’est une landing page, trois articles, un bloc sur la home, une entrée de menu, une dizaine de médias et des alias d’URL. Le tout doit apparaître en même temps, et doit pouvoir être relu dans son ensemble avant d’être mis en ligne.
C’est exactement le rôle du module Workspaces.
Ce que fait Workspaces
Un workspace est une copie parallèle du site live. Dans un workspace, on modifie des contenus, des menus, des blocs, des médias, et on navigue sur le site tel qu’il sera une fois ces changements publiés. Les visiteurs, eux, continuent de voir le live.
Quand tout est validé, on publie le workspace : l’ensemble des changements passe en live en une seule opération.
Quelques repères :
- Workspaces est dans le cœur depuis 2018 en expérimental, et stable depuis Drupal 10.3.0.
- Depuis Drupal 11.1.0, l’interface (routes, intégration toolbar) est dans un module séparé, Workspaces UI (
workspaces_ui). Le moduleworkspacesporte la logique ; on peut l’utiliser seul, en API, sans exposer d’interface. - Le live n’est pas un workspace : c’est l’état par défaut, quand aucun workspace n’est actif.
Sous le capot
Le mécanisme repose entièrement sur les révisions :
- Une entité modifiée dans un workspace est enregistrée comme une révision non par défaut. La révision par défaut, celle que voit le live, ne bouge pas.
- Le workspace garde la trace des révisions qui lui appartiennent (table
workspace_association). - Les requêtes d’entités et les Views sont altérées : dans un workspace, elles renvoient la révision du workspace quand elle existe, celle du live sinon.
- À la publication, ces révisions deviennent les révisions par défaut.
Conséquence directe : seules les entités révisionnables et publiables sont prises en charge (nœuds, blocs de contenu, médias, termes de taxonomie, liens de menu, alias d’URL…). C’est la contrainte qui structure tout le reste de cet article.
Workspaces ou Content Moderation ?
Les deux ne sont pas concurrents, ils ne travaillent pas à la même échelle.
| Content Moderation | Workspaces | |
|---|---|---|
| Unité de travail | Un contenu | Un ensemble de changements |
| Prévisualisation | Le contenu seul | Le site entier, menus et listes compris |
| Publication | Contenu par contenu | Tout le workspace d’un coup |
| Entités concernées | Celles qui ont un workflow | Toutes les entités révisionnables et publiables |
| Configuration | Non | Non (en core) |
Règle simple : si le changement tient dans un contenu, Content Moderation suffit. Dès qu’il implique plusieurs contenus qui n’ont de sens qu’ensemble, Workspaces.
Cas d’usage concrets
1. Lancement de campagne ou de produit
Le cas d’école. Pour un lancement :
- une nouvelle landing page ;
- une mise à jour de la home (bloc hero, mise en avant) ;
- une entrée dans le menu principal ;
- des fiches produit modifiées ;
- des médias et des alias d’URL.
Sans Workspaces, les équipes publient tout à la main, le jour J, en espérant ne rien oublier, avec un site incohérent pendant les vingt minutes que dure l’opération. Avec Workspaces, tout est préparé dans un workspace lancement-automne, relu en navigant sur le vrai site, puis publié en un clic.
Pour publier à une heure précise, le sous-module Workspaces Scheduler (wse_scheduler) du projet contrib Workspaces Extra planifie la publication d’un workspace.
2. Refonte d’une rubrique ou de l’arborescence
Réorganiser une section du site, c’est toucher à la fois aux contenus, à la hiérarchie du menu et aux URL. Ce sont précisément les changements qu’on ne peut pas relire contenu par contenu : un menu à moitié restructuré est un menu cassé.
Dans un workspace, on déplace les pages, on renomme les entrées, on ajuste les alias, et on vérifie la navigation réelle avant publication. Les liens de menu (menu_link_content) et les alias (path_alias) sont pris en charge par le cœur ; pour mettre en scène la hiérarchie du menu elle-même, WSE fournit le sous-module Workspaces Menu (wse_menu).
3. Contenus sous embargo
Résultats financiers, communiqué de fusion, annonce de nomination : du contenu qui doit être prêt, relu par la direction et le juridique, mais qui ne doit en aucun cas fuiter avant l’heure.
Dans un workspace, rien n’existe en live. Le contenu n’apparaît ni dans les listes, ni dans le flux RSS, ni dans le sitemap, ni dans l’index de recherche alimenté depuis le live. Les permissions du module (« voir tous les workspaces », « modifier ses propres workspaces »…) limitent qui peut y entrer, et Workspaces Group Access (wse_group_access) restreint un workspace à un groupe d’utilisateurs.
4. Validation par des personnes extérieures au back-office
Un client, un juriste, un directeur de la communication : ces relecteurs n’ont pas de compte éditeur et ne doivent pas en avoir. Ils ont besoin de voir le site final, pas un aperçu de nœud isolé.
Le projet Workspace Preview (anciennement sous-module de WSE) répond à ce besoin : un lien de prévisualisation d’un workspace partageable avec des personnes qui ne gèrent pas le contenu.
5. Plusieurs scénarios préparés à l’avance
Soirée électorale, finale sportive, annonce d’un résultat d’appel d’offres : on sait qu’un des scénarios va se produire, pas lequel. On prépare un workspace par scénario — home, article principal, bandeau, menu — et on publie celui qui correspond à la réalité. Les autres sont simplement supprimés.
C’est là que Workspaces fait gagner les minutes qui comptent : l’équipe ne rédige plus sous pression, elle choisit.
6. Travail en parallèle avec des sous-workspaces
Les workspaces sont hiérarchiques. Un workspace parent refonte-2027 peut avoir des enfants refonte-2027-produits et refonte-2027-editorial. Chaque équipe travaille dans le sien, puis fusionne dans le parent. Seul le parent est publié en live.
C’est utile quand plusieurs équipes préparent la même échéance sans vouloir se marcher dessus pendant la phase de rédaction.
7. Import en masse vérifiable avant mise en ligne
Un import (catalogue, annuaire, contenus partenaires) qui doit être contrôlé avant d’être visible. Plutôt que d’importer en non publié puis de tout publier par script, on importe dans un workspace :
use Drupal\workspaces\Entity\Workspace;
/** @var \Drupal\workspaces\WorkspaceManagerInterface $workspace_manager */
$workspace_manager = \Drupal::service('workspaces.manager');
$workspace_manager->executeInWorkspace('import_catalogue_2026', function () use ($rows) {
foreach ($rows as $row) {
// Les entités créées ou modifiées ici sont enregistrées
// dans le workspace, pas en live.
$product = \Drupal::entityTypeManager()
->getStorage('node')
->create([
'type' => 'product',
'title' => $row['title'],
// ...
]);
$product->save();
}
});
L’équipe métier navigue dans le workspace, vérifie, puis publie. Si l’import est mauvais, on supprime le workspace et le live n’a jamais été touché.
La publication se fait depuis l’interface, ou par code :
Workspace::load('import_catalogue_2026')->publish();
À réserver aux volumes raisonnables : chaque entité devient une révision suivie par le workspace, et la publication les traite toutes d’un coup. Sur plusieurs dizaines de milliers d’entités, mesurez avant de généraliser.
Les limites à connaître avant de se lancer
La configuration n’est pas versionnée par workspace. Un nouveau type de contenu, un champ, une vue, un réglage de bloc restent globaux. Dans un workspace, les formulaires de configuration non compatibles sont bloqués. Le projet contrib Workspace Config (anciennement wse_config) existe pour ce besoin, mais pour la majorité des sites la bonne réponse reste le déploiement de configuration classique (drush cex / drush cim) avant de préparer le contenu dans un workspace.
Une entité modifiée dans un workspace est verrouillée ailleurs. Tant que le workspace n’est pas publié, la même entité ne peut pas être modifiée en live ni dans un autre workspace. C’est volontaire — Drupal évite ainsi d’avoir à fusionner des conflits — mais il faut l’expliquer aux équipes : un workspace oublié peut bloquer l’édition d’une page clé pendant des semaines.
Les entités non prises en charge sont bloquées. Utilisateurs, commentaires, entités custom non révisionnables : leurs formulaires ne sont pas utilisables dans un workspace. Pour une entité custom, deux options :
- la rendre révisionnable et publiable, et elle sera prise en charge ;
- la déclarer ignorée si elle n’a pas de sens par workspace (logs, données techniques), pour qu’elle reste modifiable partout, toujours en live :
use Drupal\workspaces\Entity\Handler\IgnoredWorkspaceHandler;
/**
* Implements hook_entity_type_build().
*/
function mymodule_entity_type_build(array &$entity_types) {
$entity_types['mymodule_log']->setHandlerClass('workspace', IgnoredWorkspaceHandler::class);
}
Les requêtes SQL directes contournent Workspaces. L’isolation passe par l’Entity API, les entity queries et Views. Un \Drupal::database()->select('node_field_data') dans un module custom lit le live, même depuis un workspace. C’est le premier point à auditer dans le code existant.
Le contexte d’exécution compte. Cron, queue workers et commandes Drush ne tournent pas dans le workspace de l’utilisateur. Un traitement qui doit écrire dans un workspace doit l’activer explicitement, avec executeInWorkspace() comme dans l’exemple d’import.
Les données hors entités ne suivent pas. State API, key/value, tables custom : rien de tout cela n’est isolé par workspace.
Ce que le cœur ne fait pas (encore), et WSE si
Le cœur couvre le mécanisme. Le projet Workspaces Extra (branche 3.0.x pour Drupal 11.3+ et 12, encore en alpha) couvre une bonne partie de l’outillage dont on a besoin en production :
- un statut ouvert / fermé, le workspace se fermant à la publication ;
- le rollback des changements d’un workspace fermé ;
- le déplacement de contenus d’un workspace à l’autre ;
- l’abandon des changements d’un workspace ;
- l’écrasement (squash) des révisions intermédiaires à la publication ;
- une liste blanche de formulaires supplémentaires utilisables dans un workspace ;
- les sous-modules cités plus haut : Scheduler, Menu, Group Access, Layout Builder, Deploy, Task Monitor.
Le rollback, à lui seul, justifie souvent l’ajout du module : pouvoir annuler une campagne entière publiée par erreur, c’est une vraie garantie pour les équipes éditoriales.
Checklist avant d’adopter Workspaces
- Les changements éditoriaux typiques du site concernent plusieurs contenus liés, pas un seul.
- Toutes les entités modifiées dans ces changements sont révisionnables et publiables (ou explicitement ignorées).
- Le code custom ne lit pas les tables d’entités en SQL direct.
- Les changements de configuration sont déployés à part, avant le travail de contenu.
- Les équipes savent qu’un workspace ouvert verrouille ses contenus, et qui est responsable de le publier ou de le supprimer.
- Une procédure existe pour annuler une publication (WSE ou restauration de révisions).
Workspaces n’est pas un module qu’on active « au cas où ». Mais sur un site où chaque mise en ligne importante ressemble à une opération commando, c’est probablement la fonctionnalité du cœur la plus sous-utilisée.
