Drupal is a registered trademark of Dries Buytaert
Protected Pages 3.0.0 Major update available for module protected_pages (3.0.0). Commerce Core 3.3.8 Minor update available for module commerce (3.3.8). Search API HTML Element Filter 1.0.7 Minor update available for module search_api_html_element_filter (1.0.7). Layout Builder Reorder 2.0.1 Minor update available for module layout_builder_reorder (2.0.1). Ban 1.1.0 Minor update available for module ban (1.1.0). Field Formatter Range 2.0.0 Major update available for module field_formatter_range (2.0.0). Field Formatter Range 8.x-1.8 Minor update available for module field_formatter_range (8.x-1.8). UI Patterns (SDC in Drupal UI) 2.0.18 Minor update available for module ui_patterns (2.0.18). Search API Solr 4.3.11 Module search_api_solr updated after 14 months of inactivity (4.3.11). Provus Mega Menu Module provus_mega_menu crossed 1,000 active installs.

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.

Activity

Total releases
6
First release
Feb 2025
Latest release
2 months ago
Releases (12 mo)
4 ▲ from 2
Maintenance
Active

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