Last updated November 28, 2015. Created on March 25, 2014.
Edited by batigolix, guitarbound2015, ashish_nirmohi, mikeryan. Log in to edit this page.

The system for upgrading Drupal sites has been completely re-written for Drupal 8. The system is largely inspired by the work of the Drupal 7 Migrate and Drupal-to-Drupal Data Migration modules. It is a much more robust and extensible system than in previous major versions of Drupal core.

The functionality of the new Migrate and Migrate Drupal modules greatly expands on the functionality of previous versions of the Migrate module in that they now handle both site configuration and content.

Learn how to prepare and execute an upgrade from Drupal 6 or 7 to Drupal 8.

Upgrading from Drupal 6 and Drupal 7 sites is now possible, with support for:

  1. Drupal 6: core + CCK + Link + Email + Phone + ImageCache modules.
  2. Drupal 7: only content, users, taxonomy, blocks, menus, filter formats (more coming soon - #2456259: [META] Drupal 7 to Drupal 8 Migration path).

Migrations that are not yet supported include:

  1. Views (#2500547: Upgrade path for Views from Drupal 6 and 7)
  2. Multilingual content (#2225775: Migrate D6 i18n nodes)
  3. Node, user, entity references (#2447727: Add migrate support for Drupal 6 node & user reference

Currently, contributed modules are required to run migrations to Drupal 8.

A typical use case of the upgrade process would include installing a new copy of Drupal 8 and running the migration on the Drupal 8 site to migrate configuration and content from the source site. The source site database is not modified during the process.

Migration-Related Modules and Plugins


This Drupal core module provides the underlying API for migrating configuration and content to Drupal 8.

Migrate Drupal

This Drupal core module provides the classes specifically needed to migrate configuration and content from a Drupal site to Drupal 8.

Drupal Upgrade

The Drupal Upgrade contributed module provides the tools necessary for performing an upgrade from Drupal 6 or Drupal 7 to Drupal 8 — both a simple user interface (at /upgrade) as well as drush commands. There is on-going work to get the UI moved to Drupal core (#2573403: [meta] Outstanding tasks for upgrade UI).

Migrate Plus

The Migrate Plus contributed module provides optional enhancements, including groups and prepareRow events, to the core Migrate API.

Migrate Tools

Migrate Tools provides optional drush and UI tools for managing your migrations.

Migration plugins

Migration plugins for each core module are located within each module's directory. For example, the migration classes that handle taxonomy vocabularies and terms are located in the core taxonomy module.

Further Reading

Developer documentation is available for writing your own custom migrations.

Looking for support? Visit the forums, or join #drupal-support in IRC.