Drupal Canvas es el constructor visual de Drupal 11.3: compones piezas SDC en un lienzo con vista previa en vivo, sin editar YAML ni programar.
Funciona como sustituto de Layout Builder, no de los nodos. El contenido (artículos, productos, páginas de servicio) sigue viniendo de nodos; Canvas controla el armazón visual. Instalar el módulo no elimina Paragraphs ni obliga a migrar nada: habilita una segunda forma de componer páginas que puedes adoptar una por una.
Qué es Drupal Canvas y en qué se diferencia de Layout Builder
La diferencia práctica está en dónde vive la estructura. En Layout Builder defines layouts en configuración y el contenido entra por bloques regiones; con Paragraphs el editor mete campos estructurados y tú decides qué párrafo crear. En Canvas no hay regiones: el editor coloca componentes SDC y vistas sobre un lienzo, y cada pieza se configura con un formulario de propiedades. El resultado se guarda como configuración de página y se revisa en el mismo editor antes de publicar.
Eso implica un cambio de modelo mental para el equipo de contenido. En Layout Builder el trabajo pesado está en desarrollar el layout; en Canvas el desarrollo se concentra en crear los componentes correctos y el editor compone con ellos. Sin esa biblioteca de componentes previa, el equipo va a extrañar el "arrastrar un bloque" de Paragraphs.
La versión estable 1.0.0 salió el 4 de diciembre de 2025 y la actual es la 1.11.0, del 8 de septiembre de 2026. El ritmo de releases es alto, así que conviene leer las notas de versión del proyecto antes de cada salto.
Requisitos: qué versión de Drupal exige Canvas
Aquí es donde fallan la mayoría de las instalaciones. Canvas no corre en cualquier Drupal 11: la 1.11.0 exige drupal/core con constraint ^11.3. La 1.8.0, de julio de 2026, retiró el soporte para 11.2 porque esa rama llegó a fin de vida, así que no tiene sentido planificar sobre ella aunque el número parezca cercano.
Requisitos reales antes de empezar:
- Drupal 11.3 o superior como núcleo. En 11.2 o menos, Composer no resolverá la dependencia.
- PHP en el rango que soporte tu núcleo; lo más seguro es leer lo que exige tu
composer show drupal/core. - Base de datos igual que la del sitio (MySQL/MariaDB o PostgreSQL). Canvas no agrega requisitos extra.
- Los SDC ya están en el core desde Drupal 10.3. No necesitas instalar
drupal/sdccomo módulo contrib, paso que era obligatorio en versiones anteriores.
Comprueba tu versión antes de tocar nada:
# Desde la raíz del proyecto Drupal
composer show drupal/core | grep versions
# o, más directo sobre el sitio:
drush status --field=drupal-version
Si el resultado es menor a 11.3, actualiza primero el sitio con composer update drupal/core --with-dependencies seguido de drush updatedb, y solo después sigas con Canvas.
Instalación de Drupal Canvas con Composer
La vía recomendada es Composer, con el módulo fuera del perfil de instalación para no acoplar el sitio:
# Drupal 11.3+ — instala Canvas
composer require drupal/canvas:^1.11
Después activa los módulos que quedaron deshabilitados:
drush pm:install canvas canvas_ui -y
drush cache:rebuild
canvas es el módulo de funcionalidad y canvas_ui el que expone el editor y las herramientas de administración. Los dos hacen falta para tener la interfaz de construcción de páginas; instalar solo el primero es el error más común.
En producción, con el sitio en vivo y sin ventana de mantenimiento, el orden seguro es este:
- Respalda el código y la base de datos antes de
composer require: Composer reescribe elcomposer.locky eso puede mover dependencias de otros paquetes. - Ejecuta
composer requireen el servidor, o en tu pipeline de despliegue con--no-dev. drush updatedb -yydrush cache:rebuild.- Verifica con
drush pm:list --status=enabled --filter=canvasydrush status.
Configuración inicial después de instalar
Con los módulos activos aparecen pantallas nuevas en la administración, en las secciones de contenido y estructura. Revisa esto antes de construir nada:
- Permisos: el rol que va a construir páginas necesita los permisos de Canvas para crear, editar, eliminar y revisar composiciones. Sin el permiso de revisión, un editor puede componer pero no publicar cambios de estructura.
- Tema activo: si el tema no declara regiones o tiene una capa de layout incompatible, la vista previa puede no reflejar el resultado final. Prueba con
core/themes/oliveroantes de asumir que el fallo es de Canvas. - Idioma de la interfaz: desde la 1.8.0 la traducción ya no necesita activar un feature flag, así que la interfaz en español funciona sin pasos extra.
- Caché: límpiala después de cada cambio de configuración de composición, no solo después de instalar.
Una comprobación rápida de que todo quedó sano:
drush watchdog:show --count=10 --severity=Error
Revisar el watchdog después del primer guardado de una composición es la forma más rápida de detectar problemas de renderizado con el tema activo.
Componentes SDC, plantillas de página y Canvas AI
Componentes SDC
Los SDC (Single Directory Components) son la unidad de construcción: cada componente es una carpeta dentro de un módulo con su plantilla Twig, su CSS, su JavaScript opcional y un archivo de propiedades que define qué campos expone el formulario. Es la misma tecnología que el core usa desde 10.3, no un invento del módulo.
Como desarrollador, la forma de trabajar es crear el componente dentro de un módulo propio en vez de esperar a que exista el que necesitas:
mymodule/components/hero-banner/
hero-banner.html.twig
hero-banner.canvas.yml
hero-banner.css
hero-banner.js (opcional)
El .canvas.yml declara las propiedades que el editor va a ver: tipo, etiqueta, y si son texto, imagen, enlace o un enum de opciones. Con eso el componente aparece en el panel lateral del editor de Canvas y el equipo de contenido lo usa sin tocar código.
Plantillas de página editables
La 1.11.0 agregó plantillas de página editables e independientes del tema, más un tipo de propiedad Document que permite enlazar archivos locales como un PDF. Resuelve un caso que antes era siempre código: hoy un administrador arma la estructura "portada + descargas + formulario de contacto" sin depender del layout del tema. Los patrones de composición reutilizables llegaron antes, en la 1.10.0.
Canvas AI
Canvas AI es el asistente que se configura en el formulario Agents & Tools, también agregado en la 1.10.0. Es una capa de asistencia para generar o proponer composiciones, no un sustituto del criterio editorial. Úsalo para acelerar el primer borrador de una página, nunca como fuente de contenido publicado sin revisión humana: la responsabilidad editorial sigue siendo del equipo.
Cómo evaluar Canvas contra Layout Builder y Paragraphs
Si tienes un sitio en producción, la pregunta no es "¿reemplazo todo?", sino qué páginas cambian primero:
- Crea una composición de prueba en un tipo de contenido nuevo o en un nodo ya publicado, sin cambiar el tema.
- Reproduce la página actual en Canvas. Si necesitas bloques que no tienes como componente, ese es el trabajo real de la migración.
- Compara con el editor actual: peso del DOM, cantidad de campos por página, y quién puede editar qué.
- Mide Core Web Vitals antes y después. Los SDC traen CSS y JS propios; si los empaquetas mal, el layout shift sube.
- Decide si el resto del sitio justifica un segundo modelo mental. Mantener Layout Builder y Canvas a la vez es viable, pero documenta qué páginas usan cada uno.
El historial reciente muestra cambios de dependencia de núcleo, como el retiro de 11.2 en la 1.8.0. Cada salto mayor de Drupal puede volver a mover el requisito, así que revisa la página de releases del proyecto antes de cada actualización.
Preguntas frecuentes
¿Drupal Canvas funciona en Drupal 11.2?
No. La versión actual requiere drupal/core ^11.3, y la 1.8.0 retiró explícitamente el soporte para 11.2 porque esa rama llegó a fin de vida. Necesitas actualizar el núcleo a 11.3 o superior antes de instalar el módulo.
¿Tengo que instalar el módulo SDC aparte?
No. Desde Drupal 10.3 los Single Directory Components están en el núcleo, así que el módulo contrib drupal/sdc ya no es un paso necesario. El propio Canvas usa los SDC del core más los que definas en tus módulos.
¿Puedo usar Canvas si mi sitio ya usa Layout Builder o Paragraphs?
Sí, y es el escenario más común. Puedes instalar Canvas sin tocar las composiciones existentes de Layout Builder y migrar página por página. Lo que sí cambia es el modelo mental: en Canvas no hay regiones ni campos de párrafo, sino componentes y propiedades sobre un lienzo. Migrar todo de golpe suele ser más riesgo que valor.
¿Qué tan seguro es Canvas para un sitio en producción?
Con las cautelas correctas, sí: el módulo tiene releases numerados con notas de versión claras y miles de instalaciones reportadas en la página del proyecto. Ten en cuenta que un salto de versión de Drupal puede cambiar el requisito de núcleo. Prueba en staging, instala en producción con respaldo previo y revisa el watchdog tras la primera composición.
¿Qué son las "plantillas de página" que menciona la versión 1.11.0?
Son layouts reutilizables, editables desde la interfaz y no atados a lo que el tema traiga definido. Llegaron en la 1.11.0 junto con el tipo de propiedad Document para enlazar archivos locales como PDF. Permiten que alguien del equipo arme estructuras tipo "portada + descargas + contacto" sin escribir un módulo.
Si estás evaluando Canvas para el sitio de tu empresa y quieres estimar el trabajo de migración, escríbenos y armamos un plan con tu versión de Drupal actual, tu tema y los tipos de contenido que tienes. También podemos revisar un POS con licencia vitalicia o un ERP a medida, según lo que necesites.
