Drupal 10 on Pantheon

Your hub for all things Drupal 10.

Discuss in our Forum Discuss in Slack

Drupal 10 is now available on the Pantheon platform. This page will be updated frequently with the latest information and instructions for Drupal 10 on Pantheon.

Current Status of Drupal 10 at Pantheon

Create a Drupal 10 site on PantheonAvailableCreate a Drupal 10 Site
Upgrade a Drupal 9 site to Drupal 10 manuallyAvailableUpgrade from Drupal 9 to Drupal 10
Create a Drupal 10 site from the Pantheon DashboardAvailable
Upgrade a Drupal 9 site to Drupal 10 using the Terminus Conversion Tools pluginEarly AccessUse the following command: terminus conversion:upgrade-d10

Update a Drupal 9 Site to Drupal 10

  1. Go to your dashboard and confirm that you are on PHP 8.1. The PHP 8.1 update will show as available to install if you are not already on it.

    If you are not on PHP 8.1 and you don't see the update, refer to Upgrade PHP Versions for instructions on updating your PHP version.

  2. Run Drupal's Upgrade Status.

  3. Use Composer to update to Drupal 10. Refer to the Drupal release-specific documentation for more information.


Composer will prompt you to add phpstan/extension-installer to your allow-plugins config if you haven't done so already.

Create a Drupal 10 Site


This process requires Composer version 2.2.

  1. Create a new Drupal site using the "Drupal with Composer" CMS/Start State.

  2. Clone the site locally with Git.

  3. Run the following commands:

    composer config minimum-stability rc
    git commit -am "composer config minimum-stability rc"
    composer config platform.php 8.1
    git commit -am "composer config platform.php 8.1"
    composer config allow-plugins.phpstan/extension-installer true
    git commit -am "composer config allow-plugins.phpstan/extension-installer true"
    composer require --no-update --dev drupal/core-dev:^10
    composer require --no-update drupal/core-composer-scaffold:^10
    composer require --no-update pantheon-systems/drupal-integrations:^10
    composer require --no-update drupal/core-recommended:^10
    composer update
    git commit -am "Update to Drupal 10"
    git push origin master


When Drupal 10 is released, will my Drupal 9 site be forced to use Drupal 10?

No, Drupal 9 sites can continue to use Drupal 9 and receive Drupal 9 updates.

How do I upgrade my existing site from Drupal 9 to Drupal 10?

Refer to Upgrade from Drupal 9 to Drupal 10.

When will official Drupal 10 support start?

When Drupal 10 is officially released (expected December 14, 2022).

Where do I go with questions?

Ask questions in our Slack #drupal channel.

More Resources