Upgrading Drupal core to the latest version of 11.x

Rebranding notice!

Acquia announces rebranding of its “Acquia CMS” offering, which includes a collection of Drupal modules. “Acquia CMS” is now referred to as “Drupal Starter Kits”.

To upgrade Drupal core to the latest version of 11.x, complete the following tasks:

S. No.	Task
1	Upgrade Drupal Starter Kits to the latest version
2	Remove incompatible modules
3	Remove BLT
4	Add Drupal Recommended Settings (DRS)
5	Update Drupal core to 11.x

Upgrading Drupal Starter Kits to the latest version

Run the following command to upgrade the Drupal Starter Kits module to the latest version so that all its dependencies are also updated:

composer update "acquia/acquia_cms" -W

Removing incompatible modules

If the following modules are installed, remove them as they are not compatible with Drupal 11:

Config Filter
Google Analytics
Webform

Uninstall and remove the Webform module:

./vendor/bin/drush pmu webform
./vendor/bin/drush cex
composer remove "drupal/webform"

Install the Google Tag module, update your tag accordingly, and then uninstall the Google Analytics module:
```
./vendor/bin/drush pmu google_analytics 
composer remove "drupal/google_analytics"
./vendor/bin/drush cex
```

Removing BLT

Note

BLT is currently not compatible with Drupal core 11 and must be removed.
You can skip this step if your codebase was set up without BLT.

To remove BLT from your codebase:

Run the following command to remove BLT:
```
composer remove "acquia/blt"
```

Update the settings.php file to remove the following lines specific to BLT settings:

require DRUPAL_ROOT . '/../vendor/acquia/blt/settings/blt.settings.php';

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `blt.settings.php`. See BLT's documentation for more detail.
 *
 * @link https://docs.acquia.com/blt/

Adding Drupal Recommended Settings (DRS)

To add the DRS to your codebase:

Run the following command to add the latest version of DRS:
```
composer require "acquia/drupal-recommended-settings"
```
(For Site Factory customers only) Run the following command to add the DRS ACSF plugin to your codebase:
```
composer require "acquia/drs-acsf"
```

(For existing sites only) Verify that the settings.php file contains the following lines specific to DRS settings.

require DRUPAL_ROOT . "/../vendor/acquia/drupal-recommended-settings/settings/acquia-recommended.settings.php";

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `acquia-recommended.settings.php`. See DRS's documentation for more detail.
 */

If the settings.php file does not contain these lines, add them manually.

Updating Drupal core to 11.x

To update Drupal core:

Run the following command to add the latest version of the core module:

composer require "drupal/core-composer-scaffold:^11" "drupal/core-recommended:^11"  "drush/drush:^13"  --no-update --no-install

Run the following command to update Drush and PHPUnit to the latest versions:
```
composer require "phpunit/phpunit:^10" --dev --no-update --no-install
```
Run the following command to install the latest Drupal core and its required dependencies:
```
composer update -W
```

Perform the following post upgrade tasks:

./vendor/bin/drush cr
./vendor/bin/drush updb -y

./vendor/bin/drush coh:import
./vendor/bin/drush coh:rebuild

./vendor/bin/drush cex

Commit all the changes, deploy them to your development environment, and then run the following commands:
```
./vendor/bin/drush cr
./vendor/bin/drush cim --yes
./vendor/bin/drush updb --yes
```
Verify that the site in your development environment works as expected.

Rebranding notice!

Acquia announces rebranding of its “Acquia CMS” offering, which includes a collection of Drupal modules. “Acquia CMS” is now referred to as “Drupal Starter Kits”.

To upgrade Drupal core to the latest version of 11.x, complete the following tasks:

S. No.	Task
1	Upgrade Drupal Starter Kits to the latest version
2	Remove incompatible modules
3	Remove BLT
4	Add Drupal Recommended Settings (DRS)
5	Update Drupal core to 11.x

Upgrading Drupal Starter Kits to the latest version

Run the following command to upgrade the Drupal Starter Kits module to the latest version so that all its dependencies are also updated:

composer update "acquia/acquia_cms" -W

Removing incompatible modules

If the following modules are installed, remove them as they are not compatible with Drupal 11:

Config Filter
Google Analytics
Webform

Uninstall and remove the Webform module:

./vendor/bin/drush pmu webform
./vendor/bin/drush cex
composer remove "drupal/webform"

Install the Google Tag module, update your tag accordingly, and then uninstall the Google Analytics module:
```
./vendor/bin/drush pmu google_analytics 
composer remove "drupal/google_analytics"
./vendor/bin/drush cex
```

Removing BLT

Note

BLT is currently not compatible with Drupal core 11 and must be removed.
You can skip this step if your codebase was set up without BLT.

To remove BLT from your codebase:

Run the following command to remove BLT:
```
composer remove "acquia/blt"
```

Update the settings.php file to remove the following lines specific to BLT settings:

require DRUPAL_ROOT . '/../vendor/acquia/blt/settings/blt.settings.php';

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `blt.settings.php`. See BLT's documentation for more detail.
 *
 * @link https://docs.acquia.com/blt/

Adding Drupal Recommended Settings (DRS)

To add the DRS to your codebase:

Run the following command to add the latest version of DRS:
```
composer require "acquia/drupal-recommended-settings"
```
(For Site Factory customers only) Run the following command to add the DRS ACSF plugin to your codebase:
```
composer require "acquia/drs-acsf"
```

(For existing sites only) Verify that the settings.php file contains the following lines specific to DRS settings.

require DRUPAL_ROOT . "/../vendor/acquia/drupal-recommended-settings/settings/acquia-recommended.settings.php";

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `acquia-recommended.settings.php`. See DRS's documentation for more detail.
 */

If the settings.php file does not contain these lines, add them manually.

Updating Drupal core to 11.x

To update Drupal core:

Run the following command to add the latest version of the core module:

composer require "drupal/core-composer-scaffold:^11" "drupal/core-recommended:^11"  "drush/drush:^13"  --no-update --no-install

Run the following command to update Drush and PHPUnit to the latest versions:
```
composer require "phpunit/phpunit:^10" --dev --no-update --no-install
```
Run the following command to install the latest Drupal core and its required dependencies:
```
composer update -W
```

Perform the following post upgrade tasks:

./vendor/bin/drush cr
./vendor/bin/drush updb -y

./vendor/bin/drush coh:import
./vendor/bin/drush coh:rebuild

./vendor/bin/drush cex

Commit all the changes, deploy them to your development environment, and then run the following commands:
```
./vendor/bin/drush cr
./vendor/bin/drush cim --yes
./vendor/bin/drush updb --yes
```
Verify that the site in your development environment works as expected.

Rebranding notice!

Acquia announces rebranding of its “Acquia CMS” offering, which includes a collection of Drupal modules. “Acquia CMS” is now referred to as “Drupal Starter Kits”.

To upgrade Drupal core to the latest version of 11.x, complete the following tasks:

S. No.	Task
1	Upgrade Drupal Starter Kits to the latest version
2	Remove incompatible modules
3	Remove BLT
4	Add Drupal Recommended Settings (DRS)
5	Update Drupal core to 11.x

Upgrading Drupal Starter Kits to the latest version

Run the following command to upgrade the Drupal Starter Kits module to the latest version so that all its dependencies are also updated:

composer update "acquia/acquia_cms" -W

Removing incompatible modules

If the following modules are installed, remove them as they are not compatible with Drupal 11:

Config Filter
Google Analytics
Webform

Uninstall and remove the Webform module:

./vendor/bin/drush pmu webform
./vendor/bin/drush cex
composer remove "drupal/webform"

Install the Google Tag module, update your tag accordingly, and then uninstall the Google Analytics module:
```
./vendor/bin/drush pmu google_analytics 
composer remove "drupal/google_analytics"
./vendor/bin/drush cex
```

Removing BLT

Note

BLT is currently not compatible with Drupal core 11 and must be removed.
You can skip this step if your codebase was set up without BLT.

To remove BLT from your codebase:

Run the following command to remove BLT:
```
composer remove "acquia/blt"
```

Update the settings.php file to remove the following lines specific to BLT settings:

require DRUPAL_ROOT . '/../vendor/acquia/blt/settings/blt.settings.php';

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `blt.settings.php`. See BLT's documentation for more detail.
 *
 * @link https://docs.acquia.com/blt/

Adding Drupal Recommended Settings (DRS)

To add the DRS to your codebase:

Run the following command to add the latest version of DRS:
```
composer require "acquia/drupal-recommended-settings"
```
(For Site Factory customers only) Run the following command to add the DRS ACSF plugin to your codebase:
```
composer require "acquia/drs-acsf"
```

(For existing sites only) Verify that the settings.php file contains the following lines specific to DRS settings.

require DRUPAL_ROOT . "/../vendor/acquia/drupal-recommended-settings/settings/acquia-recommended.settings.php";

/**
 * IMPORTANT.
 *
 * Do not include additional settings here. Instead, add them to settings
 * included by `acquia-recommended.settings.php`. See DRS's documentation for more detail.
 */

If the settings.php file does not contain these lines, add them manually.

Updating Drupal core to 11.x

To update Drupal core:

Run the following command to add the latest version of the core module:

composer require "drupal/core-composer-scaffold:^11" "drupal/core-recommended:^11"  "drush/drush:^13"  --no-update --no-install

Run the following command to update Drush and PHPUnit to the latest versions:
```
composer require "phpunit/phpunit:^10" --dev --no-update --no-install
```
Run the following command to install the latest Drupal core and its required dependencies:
```
composer update -W
```

Perform the following post upgrade tasks:

./vendor/bin/drush cr
./vendor/bin/drush updb -y

./vendor/bin/drush coh:import
./vendor/bin/drush coh:rebuild

./vendor/bin/drush cex

Commit all the changes, deploy them to your development environment, and then run the following commands:
```
./vendor/bin/drush cr
./vendor/bin/drush cim --yes
./vendor/bin/drush updb --yes
```
Verify that the site in your development environment works as expected.

Upgrading Drupal Starter Kits to the latest version

Removing incompatible modules

Removing BLT

Adding Drupal Recommended Settings (DRS)

Updating Drupal core to 11.x

Upgrading Drupal Starter Kits to the latest version

Removing incompatible modules

Removing BLT

Adding Drupal Recommended Settings (DRS)

Updating Drupal core to 11.x

Upgrading Drupal Starter Kits to the latest version

Removing incompatible modules

Removing BLT

Adding Drupal Recommended Settings (DRS)

Updating Drupal core to 11.x

Did not find what you were looking for?

Did not find what you were looking for?