Drupal is a registered trademark of Dries Buytaert
cms 2.1.3 Update released for Drupal core (2.1.3)! drupal 10.5.11 Update released for Drupal core (10.5.11)! drupal 11.3.11 Update released for Drupal core (11.3.11)! drupal 11.2.13 Update released for Drupal core (11.2.13)! drupal 10.6.10 Update released for Drupal core (10.6.10)! cms 2.1.2 Update released for Drupal core (2.1.2)! drupal 11.1.10 Update released for Drupal core (11.1.10)! drupal 10.5.10 Update released for Drupal core (10.5.10)! drupal 10.4.10 Update released for Drupal core (10.4.10)! drupal 11.2.12 Update released for Drupal core (11.2.12)! drupal 11.3.10 Update released for Drupal core (11.3.10)! drupal 10.6.9 Update released for Drupal core (10.6.9)! drupal 10.6.8 Update released for Drupal core (10.6.8)! drupal 11.3.9 Update released for Drupal core (11.3.9)! drupal 11.3.8 Update released for Drupal core (11.3.8)! drupal 11.3.7 Update released for Drupal core (11.3.7)! drupal 11.2.11 Update released for Drupal core (11.2.11)! drupal 10.6.7 Update released for Drupal core (10.6.7)! drupal 10.5.9 Update released for Drupal core (10.5.9)! cms 2.1.1 Update released for Drupal core (2.1.1)!

WordPress Migrate SQL lets you build migrations from a WordPress site's MySQL/MariaDB database straight into Drupal. It's recommended for complex WordPress sites and for people who prefer a pure SQL source over WXR exports.

It also offers a ready-to-use migration for common WordPress content and a page to import or roll them back, with not need to write code.

Full setup and usage instructions are in the module's README.md.

Features

  • Migrate source plugins for WordPress Users, Terms, Posts (with tags, categories and featured image) and Attachments.
  • UI form to configure the WordPress database connection (host, user, password, prefix) and the files base URL, with a built-in "Test connection" button. No settings.local.php tweaks required.
  • Process plugins:
    • wordpress_migrate_sql_file_import: downloads remote attachments and saves them as local File entities.
    • wordpress_migrate_sql_unique_username: avoids duplicate-username collisions during user migration.
  • Zero-code setup via the bundled WordPress Migrate SQL - Basic submodule: ready-to-run migrations plus an Import/Rollback page. On enable, it installs the Categories vocabulary, a field_categories entity-reference field on the Article content type, and wires the posts migration to populate it from WordPress category terms. See modules/basic/README.md for step-by-step instructions.
  • Drush scaffolder (drush generate wordpress-migration) that creates a custom module with the four default migrations — plus optional config for the categories vocabulary and field — so you can tailor them to your content model. See the Scaffolding section of README.md for details.

Additional documentation

Similar projects

  • WordPress Migrate: provides a full content migration from WordPress to Drupal based on the WordPress WXR export format.
  • Wordpress to Drupal Migrate: Pretty similar than this module. It already support pages, comments and common shortcodes.
  • This module differentiates from others to provide a solution that is able to be installed without needing to code, but also allow developers to make customized migrations. Customized migrations allow cover use cases that are not covered by the basic migration.

    In future plans the module will also provide reports to quick glance which content is migrated and which content is still missing.

Activity

Total releases
6
First release
Feb 2025
Latest release
4 weeks ago
Release cadence
91 days
Stability
33% stable

Release Timeline

Releases

Version Type Release date
1.0.1 Stable May 5, 2026
1.0.0 Stable Apr 22, 2026
1.x-dev Dev Apr 22, 2026
1.0.0-alpha15 Pre-release Feb 4, 2026
1.0.0-alpha14 Pre-release Feb 3, 2025
1.0.0-alpha13 Pre-release Feb 3, 2025