WordPress Migrate

wordpress_migrate supports migrating WordPress blog exports (WXR format) into Drupal using the Migrate module / API, which is now in Drupal core. Import of WordPress posts, pages, comments, attachments, tags and categories is supported. Imports can be rolled back completely.

Now Drupal 10.5 + 11 compatible!

See the documentation landing page and FAQ. New to Drupal? Check out WordPress and Drupal terminology and concepts, and how to generate WordPress test content to test migrations.

The Drupal 10/11 version now released (alpha 9) on the 8.x-3.x branch with Drush 13.x CLI support (analogous to WP-CLI in WordPress world). See the Readme for new Drush commands.

Dependencies

We are now at PHP8.2 and Drupal 10.5+ or Drupal 11 (to match migrate_plus). Version 8.x-3.x requires pathauto, migrate_tools (6.x preferred), migrate_plus (6.0.9+ required) and ctools (3.4+ or 4.0+). Drush 13 is now added.

Acknowledgements

Original wordpress_migrate development on Drupal 7 was sponsored by Acquia. Development during 2017-2019 was sponsored by kor group.

Earlier versions

For Drupal 11 see: #3435726 and #2904990: Plan for wordpress_migrate 8.x-3.x beta release for major issues.

Drupal 9 support was added in alpha4 and Drupal 10 compatible with alpha6. Alpha8 is the last version supporting Drupal 9.x, 10.0.x, and 10.1.x. Going into Alpha 9, we will only support Drupal 10.2.x+ and Drupal 11.

The Drupal 7 & 8 versions are not being actively developed - the current focus is on D9-11. Docs for Drupal 7 version here.

In older versions drush 8 is recommended to run the migration. Version 7.x-2.4 requires Migrate 2.7 or later. Migrate Extras is recommended if you have Pathauto installed and enabled and required if you have Media installed and enabled.

Similar projects

The new wordpress_migrate_recipe offers Drupal recipe support which is based on this module - a kind of starter kit.

WordPress Migrate SQL: Enables customized migrations based on Wordpress SQL sites, allowing migration of complex WordPress sites, using a SQL source. wp_migrate is another module which is compatible with up to Drupal 9.