Last updated October 26, 2013. Created on May 10, 2011.
Edited by xjm, LeeHunter, loopduplicate, JohnAlbin. Log in to edit this page.

This handbook provides information and specific steps for upgrading contributed and custom modules from Drupal 7 to Drupal 8.

Should I start upgrading now?

Drupal 8 is in its API completion phase, which means that after over two years of development, we're doing final work to finish the APIs that will ship with Drupal 8.0, including completing conversions, improving performance, and refining the developer experience.

  • If you'd like to help core developers find bugs and improve the developer experience, now is a good time to start exploring Drupal 8, but there will still be some API changes that can break contributed modules between now and Drupal 8.0.
  • If you want to avoid having to revise your module's code, you should instead wait for the first Drupal 8 release candidate before you begin your module upgrade.

Take a look at What Drupal 8 API changes are still outstanding? for some of the most important changes we're still planning to make. For more information, review the documentation on the Drupal 8 release cycle and see Dries' blog post, Drupal 8 APIs are freezing but not frozen.

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