Install
Works with Drupal: ^11.3Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
Content templates
- Content templates can be created for not just nodes, but for most content entity type with configurable displays.
(JavaScript) Code components
- Code components can now be server-side rendered via the new
canvas_ssrsubmodule if Deno is installed. - Code components can now retrieve
t()and related functions from a React hook for translating the hard-coded strings within their code. - Code components can now receive a list of content entity references ("multiple-cardinality") rather than just a single one ("single-cardinality").
Editor
- The editor preview is now faster, and drag and drop is more accurate.
- Link props can now link to Canvas pages as well as nodes.
AI
- Canvas AI now lets you stop a response in progress and shows the selected component in the chat.
Headless
- Headless previews and component sync are now more reliable.
- The Headless SDK now supports the json-render format for rendering Canvas content across all supported frontend frameworks.
Other noteworthy fixes
- Canonical URL generation for the site's homepage when using Canvas pages
- Translation of empty fields
- Admin pages rendering in the front-end theme
- Drupal 11.5 compatibility
Contributors (60)
ahmad-khalil-imagex, aivazashvilit, ajabhinavjha30, akhil babu, andrewbelcher, anshika agrawal, anshika.agrawal, balintbrews, balsama, bnjmnm, cadence96, carolpettirossi, chadpeppers, chandu7929, csakiistvan, daniel_arend, effulgentsia, f.mazeikis, f0ns, flyke, goba, gábor hojtsy, harjot.singh, harjot.singh@acquia.com, heyyo, hooroomoo, isholgueras, jerdavis, jgoldd, jucs7, julien, justafish, kieran.cott, kotekirkitadze, kunal.sachdev, lauriii, longwave, marcus_johansson, mariosr, matthand, mayur-sose, merilainen, mglaman, narendrar, pameeela, penyaskito, pfrilling, phenaproxima, pravesh_poonia, pray_12, rduterte, shqshqnk, shubham.prakash, tedbow, thejimbirch, tim.plunkett, ultimike, utkarsh_33, wim leers, wotnak
Changelog
Issues: 99 issues resolved.
Changes since 1.12.0 (compare):
Bug
- task(CI): #3592133 lint (php) fails: phpstan/phpstan-phpunit 2.0.19 conflicts with the phpstan/phpstan 2.2.3 pin
- fix: #3592057 Support mapping multi-valued list fields to array-type component props
- fix: #3591909 User cannot publish changes after unpublishing a page when Metatag module is installed
- fix(AI): #3592089 Canvas AI: Update the description of canvas_component_agent
- fix(AI): #3592002 Normalize agent-written prop values against their schema and report values the component source cannot store
- fix(deps): update npm minor and patch
- fix: #3592142 ColorFormPopover resets edits in progress when the color list refetches
- fix: #3592145 Emit #main-content anchor at the page variant content marker so the theme skip link has a target
- fix: #3592150 Missing Border for color prop example value - Brand Kit V1
- fix(CI): #3592168 Pin phpstan/phpstan-phpunit to 2.0.21, as 2.1.0 requires PHPStan 2.3
- fix: #3592084 Canvas entity edit/delete/translation routes render in the front-end theme instead of the admin theme
- fix: #3591848 ∅ is added for empty fields, forcing translation and rendering on the page
- fix: #3591843 Cannot delete a component after removing its last usage until Canvas is reloaded
- fix: #3591894 Error message for empty value is displayed for select props even when they're not required
- fix(Auto-save): #3591785: Update
canvas_post_update_0026_rehash_auto_save_items()to guide the site admin to disable assertions on production sites - fix(Theme builder): #3591748 Hydrate components with diamond dependencies
- fix: #3592191 Spacing for the loading indicator is off (missing spacing from right)
- bug: #3589193 Marking a non-named code prop "Required" also marks other unnamed props required
- fix(CLI Tool): #3592109 CLI pull/push loses entity references and options in component link props
- fix(CI): #3592229 Update affected tests from simple_oauth 6.1.2 release
- fix(AI): #3592122 Canvas AI: get_component_details and get_component_context omit item type and item limits of multi-value props
- fix: #3592184
list_stringfield withallowed_values_functioncrashes content templates when its labels areTranslatableMarkup - fix: #3592176 Duplicating a page template silently does nothing: the GET representation is no longer a valid POST body
- fix(AI): #3592123 Canvas AI: removeMediaFields() drops arrays of media IDs for multi-value media props
- fix(CLI Tool,Headless): #3592255 CLI pull imports headless dependencies and causes non-headless components to become external
- fix(Headless): #3592224 Allow component definition updates across headless frontends
- fix(Headless): #3592257 Support non-revisionable resources in Headless SDK draft mode
- bug: #3592179 Canvas editor is built with the site's front-end theme, not canvas_stark
- fix: #3592228 Playwright brandKitColors spec intermittently failing
- fix(Page): #3592266 Users with "delete canvas_page" cannot delete old page revisions
- fix(Config management): #3592212 Allow config import to recreate in-use components with the same versions
- fix(Page builder): #3592276 Make preview drag and drop target the position under the cursor
- fix: #3592279 Editor does not scroll to the top of the page preview on load
- fix(Brand Kit): #3592282 Fix Brand Kit color test flakiness caused by folder menu focus restoration
- fix(Page builder): #3592281 Editor preview can start at the wrong position after page height changes
- fix: #3592275 Let users who can see components see folders
- fix(Theme builder): #3592270 Keep jsonapi-client out of a hashed shared chunk in astro-hydration
- fix(Headless): #3592265 Improve headless component sync compatibility with page templates
- fix(AI): #3592222 Canvas AI: Stopped turn's message is lost when tool calls are kept in history
- fix(Data model, Translation): #3592071 Default content import only resolves CANVAS_ENTITY_REFERENCE inputs in the default translation
- fix: #3592325 Mutations keep failing with a stale CSRF token when the 403 response has an HTML body
- fix(Shape matching): #3592316 A
type: array, items: {type: object …}prop linked to a multi-valued entity field (EntityFieldPropSource) gets an object of lists, not a list of objects - fix: #3592273 Drupal 11.5 fail: Tests use slot names with dashes
- fix(Headless): #3592337 Render headless previews on unpublished canonical entity pages
- fix(Page builder): #3592331 Update the preview in place on prop edits instead of reloading the iframe
- fix: #3558305 Canonical URL metatag is hard coded for Canvas pages and can't be modified
- fix: #3592340 Show changes to the layout in the preview immediately, and keep stale server renders from undoing them
- fix(Page builder): #3592353 An entity rendered with a Canvas
ContentTemplateloses its own cache tags/contexts/max-age - fix(Headless): #3592358 Pin drupal/custom_elements to ~3.4.1 until Canvas Headless supports 3.5.0
- fix: #3582851 Drupal completely breaks when installing the core block_content module alongside Canvas
- fix: #3592207 Show notification and block user actions when maintenance mode is activated
- fix: #3592250 Add a contributed modules page to the Canvas docs
- fix: #3592377 Uninstalling block_content fails with "Table 'block_content' doesn't exist" when Layout Builder is enabled
Feature
- feat(AI): #3592082 Canvas AI: Trim the place_components and edit_components results kept in the conversation state
- feat(Brand Kit): #3591930 Apply brand kit color changes optimistically
- feat: #3592132 Allow modules to add operations to the Canvas content list
- feat(AI): #3592085 Canvas AI: Let the user stop a running chat turn
- feat: #3592009 Add locale-aware date/time formatting function (JS) for code components
- feat(AI): #3592221 Canvas AI: Show the selected component in the AI chat input
- feat(Page): #3579496 Add a way to view the previous versions of a page
- feat(Page builder): #3592274 Replace the props form loading spinner with a skeleton placeholder
- feat: #3592277 Reuse the session's CSRF token instead of fetching it before every mutation
- feat(Config management, Data model): #3592256 Add
dr canvas:audit:usagecommand - feat(Component sources, Theme builder): #3592327 A code component cannot get the URL of a referenced entity, so a list of
content-entity-references cannot (reliably) link to its items - feat(AI): #3592296 Canvas AI: Show a fallback progress message when an agent calls a tool without narrating
- feat(Theme builder,CLI Tool,Headless): #3592259 Add translatable strings to Code Components
- feat(Theme builder): #3589536 Support multi-cardinality for content-entity-reference prop shape
- feat: #3518272 Support all entity types with configurable displays for content templates
- feat: #3592359 Add a canvas_ssr submodule for server-side rendering of Code Components
- feat: #3592375 Allow content templates for content entity types without a page of their own:
Mediain every case, andBlockContent - feat: #3592175
resolveEntityUri()hardcodesentity:node/, so link props can never target any other entity type - feat(Headless): #3591892 Implement json-render in Headless SDK
Misc
- task(deps): #3592156 Pin @playwright/test to 1.59.0 and block Renovate updates
- task(AI): #3591958 Canvas AI: Unify error handling in the dev page builder agent's tools
- task(CI): #3592144: Add an eslint rule to block creating new Cypress tests
- task(AI): #3592160 Canvas AI: Move getSupportedLibraries() to CanvasAiPageBuilderHelper
- task(AI): #3592161 Canvas AI: Show the AI provider error when a chat turn fails
- ci: #3592199 Cypress tests are not retrying in CI
- task(AI): #3592021 Canvas AI: Unify error handling in
canvas_component_agent's tools - task(AI): #3592120 Canvas AI: Give the Canvas Agent editor-facing knowledge about Drupal Canvas
- test(AI): #3592134 Canvas AI: Cover a full place-and-edit conversation in DrupalCanvasPageAgentEndToEndTest
- ci: #3592319 Share CI package cache in forks
- ci: #3592319 Share CI package cache in forks
- test(AI): #3592252 Canvas AI: Add Playwright coverage for multi-value prop values placed by the page agent
- ci: #3592213 Record stats for flaky tests
- task(Tests): #3592362 Make the tests compatible with PHPUnit 12, which Drupal 12 uses
- Add built assets for release 1.13.0
Task
- chore(deps): update dependency cspell to v10
- chore(deps): update dependency dotenv-defaults to v6
- chore: #3591874 Upgrade the Canvas UI to React Router 7
- chore(deps): #3588803 Update packages to Astro v7
- chore(CI): #3592198 Guard code component runtime portability with ESLint and an agent skill
- refactor(Theme builder): #3588803 Replace 'raw' prop reviver with JSON-serialized props in Astro hydration
- task: #3540095 Cypress to Playwright - Part 0/22: add plan ledger and remove redundant and easily ported Cypress tests.
- chore: #3592177 Upgrade to Vite 8
- task: #3540095 Cypress to Playwright - Part 1/22: expand plan ledger, remove Cypress autosave and fold uncovered assertions into existing Playwright tests
- fix: #3592248 Add #[RunTestsInSeparateProcesses] to tests missing it for Drupal 12 compatibility
- chore: #3592313 Rename
dr canvas:audit:usagetodr canvas:component:audit, before the first release that has it - chore(Project management): #3592272 Add the new optional method parameters from Drupal 12, so Canvas classes load there
- chore(deps): update node.js to v24.22.2
- chore(deps): #3592350 Address npm dependency security advisories
- task: #3574725 Add documentation for all available formats for the string prop
- chore(Validation): #3592332 Modernize validation constraint instantiation for Drupal 12 / Symfony 8 compatibility
- chore(deps): Address npm dependency security advisories
- chore: version packages
- chore: version packages
- chore(CI): #3592393 Pin core versions to latest security releases for CI and add compatibility for 11.4.13