Updating Source CMS from Experience Builder to Drupal Canvas

On Tuesday, 21 October 2025, Acquia will release a scheduled update for Source CMS that renames Experience Builder to Drupal Canvas. 

Sites, including components and content, are updated automatically requiring no action from customers unless you are storing copies of components externally. If you are storing components outside of Source CMS, your team can use one of two options to update your exported components to use Drupal Canvas: 

1. Re-download components
2. Manually update components

Using the following steps to complete either option to update your Source CMS application.

Option 1: Re-download components (recommended)

1. Re-download components from Source CMS using the CLI tool.

   All newly downloaded components will leverage Drupal Canvas.

Option 2: Manually update components

1. Replace json-schema-definitions://experience_builder.module/image with json-schema-definitions://canvas.module/image in all component.yml files.
2. Replace json-schema-definitions://experience_builder.module/video with json-schema-definitions://canvas.module/video in all component.yml files.
3. If you have $ref: json-schema-definitions://experience_builder.module/textarea in any of your component.yml files:
   1. Remove that line.
   2. Insert the following definition instead:
      contentMediaType: text/html
x-formatting-context: block