Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

WordPress Migrate SQL

Security covered Under active development 29 sites

This module allows you to migrate content from a WordPress database directly into Drupal, offering a pure SQL source alternative to WXR exports. It provides ready-to-use migrations for common WordPress content and a user interface for import and rollback without coding, while also supporting custom migration development for complex needs.

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.

Drupal 11 · not 10

Ask your assistant about WordPress Migrate SQL

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

  • file Drupal core
  • migrate Drupal core

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
19
Tracked since
Feb 2024
Latest release
5 months ago
Releases (12 mo)
4 ▲ from 2
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.1 Stable 11 May 5, 2026
1.0.0 Stable 11 Apr 22, 2026
1.x-dev Dev 11 Apr 22, 2026
1.0.0-alpha15 Pre-release 10–11 Feb 4, 2026
1.0.0-alpha14 Pre-release 10–11 Feb 3, 2025
1.0.0-alpha13 Pre-release 10–11 Feb 3, 2025
1.0.0-alpha12 Pre-release 10–11 Apr 15, 2024
1.0.0-alpha11 Pre-release 10–11 Apr 10, 2024
1.0.0-alpha10 Pre-release 10–11 Apr 10, 2024
1.0.0-alpha9 Pre-release 10 Mar 26, 2024