Upgrading Drupal

To upgrade from Drupal 6 or Drupal 7 site see Upgrading from Drupal 6 or Drupal 7.

For minor version or patch version updates see instructions for updating Drupal.

Sites must upgrade to each major Drupal version.

A major version cannot be skipped during an upgrade. For example, to upgrade from Drupal 9 to Drupal 11, sites must upgrade from Drupal 9 to Drupal 10 then to Drupal 11. This minimizes the number of core and contributed extension database upgrades that sites run at the same time.

This is a design choice that improves Drupal stability and simplifies maintenance of upgrade paths.

Upgrade process overview

Considerations when doing a Drupal upgrade, like why you cannot skip a major version.

How to upgrade from Drupal 11 to Drupal 12

Instructions for a major version upgrade from Drupal 11 to Drupal 12 using Composer.

How to upgrade from Drupal 10 to Drupal 11

Instructions for a major version upgrade from Drupal 10 to Drupal 11 using Composer.

How to upgrade from Drupal 9 to Drupal 10

Instructions for a major version upgrade from Drupal 9 to Drupal 10 using Composer.

How to upgrade from Drupal 8 to Drupal 9

Instructions for how to upgrade from Drupal 8 to Drupal 9.

Migrating dependencies on Drupal core jQuery UI libraries

Drupal core no longer provides jQuery UI libraries, and must use contrib modules instead.

Guide maintainers