FG Drupal to WordPress


This plugin migrates articles, stories, pages, categories, tags and images from Drupal to WordPress.

It has been tested with Drupal 4, 5, 6, 7, 8, 9 & 10 and the latest version of WordPress. It is compatible with multisite installations.

Major features include:

  • migrates the Drupal articles
  • migrates the Drupal 6 stories
  • migrates the Drupal basic pages
  • migrates the Drupal categories
  • migrates the Drupal tags
  • migrates the Drupal images
  • uploads all the posts media in WP uploads directories
  • uploads external media (option)
  • modifies the post content to keep the media links
  • resizes images according to the sizes defined in WP
  • defines the featured image to be the first post image (option)
  • keeps the alt image attribute
  • modifies the internal links
  • compatible with the MySQL, PostgreSQL and SQLite Drupal database drivers

No need to subscribe to an external web site.

Premium version

The Premium version includes these extra features:

  • migrates the comments
  • migrates the authors
  • migrates the administrators
  • migrates the users
  • migrates the custom post types
  • migrates the custom taxonomies
  • migrates the custom fields
  • migrates the custom users fields
  • migrates the users pictures
  • migrates the navigation menus
  • migrates the blocks as inactive widgets
  • authenticates the users with their Drupal passwords
  • SEO: redirects the Drupal URLs to the corresponding WordPress URLs
  • ability to not import some data
  • ability to import only specific node types
  • imports and replaces the Image Assist shortcodes
  • imports the images managed by the Image Attach Drupal module
  • imports the nodes relationships
  • imports the Drupal 8 Media entities
  • imports the Drupal Media
  • imports the Video Embed fields
  • ability to run the import by WP CLI

The Premium version can be purchased on: https://www.fredericgilles.net/fg-drupal-to-wordpress/


The Premium version allows the use of add-ons that enhance functionality:

  • CCK Custom Content Kit
  • ECK Entity Construction Kit
  • Meta tags
  • Location custom fields
  • Ubercart store
  • Drupal Commerce store
  • Name custom fields
  • Addressfield custom fields
  • Internationalization
  • NodeBlock fields
  • EntityReference relationships
  • Media Provider (S3, SoundCloud, YouTube media)
  • Forum
  • Field collections
  • Multifield
  • Paragraphs
  • Domain Access
  • Countries
  • Profile2 user fields
  • Entity Embed
  • Webform
  • Book

These modules can be purchased on: https://www.fredericgilles.net/fg-drupal-to-wordpress/add-ons/


  • English (default)
  • French (fr_FR)
  • other can be translated


  • Parameters screen


  1. Install the plugin in the Admin => Plugins menu => Add New => Upload => Select the zip file => Install Now
  2. Activate the plugin in the Admin => Plugins menu
  3. Run the importer in Tools > Import > Drupal
  4. Configure the plugin settings. You can find the Drupal database parameters in the Drupal file sites/default/settings.php


I get the message: “[fg-drupal-to-wp] Couldn’t connect to the Drupal database. Please check your parameters. And be sure the WordPress server can access the Drupal database. SQLSTATE[28000] [1045] Access denied for user ‘xxx’@’localhost’ (using password: YES)”

  • First verify your login and password to the Drupal database.
    If Drupal and WordPress are not installed on the same host:
  • If you use CPanel on the Drupal server, a solution is to allow a remote MySQL connection.
    • go into the Cpanel of the Drupal server
    • go down to Database section and click “Remote MySQL”
    • There you can add an access host (WordPress host). Enter the access host as the SOME-WEBSITE-DOMAIN-OR-IP-ADDRESS and click add host.
  • Another solution is to copy the Drupal database on the WordPress database:
    • export the Drupal database to a SQL file (with phpMyAdmin for example)
    • import this SQL file on the same database as WordPress
    • run the migration by using WordPress database credentials (host, user, password, database) instead of the Drupal ones in the plugin settings.

I get this error when testing the connection: “SQLSTATE[HY000] [2002] Connection refused” or “SQLSTATE[HY000] [2002] No such file or directory”

  • This error happens when the host is set like localhost:/tmp/mysql5d.sock
    Instead, you must set the host to be localhost;unix_socket=/tmp/mysql5d.sock

The migration stops and I get the message: “Fatal error: Allowed memory size of XXXXXX bytes exhausted” or I get the message: “Internal server error”

  • First, deactivate all the WordPress plugins except the ones used for the migration
  • You can run the migration again. It will continue where it stopped.
  • You can add: define('WP_MEMORY_LIMIT', '512M'); in your wp-config.php file to increase the memory allowed by WordPress
  • You can also increase the memory limit in php.ini if you have write access to this file (ie: memory_limit = 1G). See the increase memory limit procedure.

The media are not imported

  • Check the URL field that you filled in the plugin settings. It must be your Drupal home page URL and must start with http:// or https://

The media are not imported and I get the error message: “Warning: copy() [function.copy]: URL file-access is disabled in the server configuration”

  • The PHP directive “Allow URL fopen” must be turned on in php.ini to copy the medias. If your remote host doesn’t allow this directive, you will have to do the migration on localhost.

I get the message: “Fatal error: Class ‘PDO’ not found”

  • PDO and PDO_MySQL libraries are needed. You must enable them in php.ini on the WordPress host.
    Or on Ubuntu:
    sudo php5enmod pdo
    sudo service apache2 reload

I get this error: PHP Fatal error: Undefined class constant ‘MYSQL_ATTR_INIT_COMMAND’

  • You have to enable PDO_MySQL in php.ini on the WordPress host. That means uncomment the line extension=pdo_mysql.so in php.ini

Does the migration process modify the Drupal site it migrates from?

  • No, it only reads the Drupal database.

I get this error: Erreur !: SQLSTATE[HY000] [1193] Unknown system variable ‘NAMES’

  • It comes from MySQL 4.0. It will work if you move your database to MySQL 5.0 before running the migration.

I get this error “Parse error: syntax error, unexpected T_PAAMAYIM_NEKUDOTAYIM”

  • You must use at least PHP 5.3 on your WordPress site.

I get this error: SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client

  • It is a compatibility issue with your version of MySQL.
    You can read this post to fix it: http://forumsarchive.laravel.io/viewtopic.php?id=8667

None image get transferred into the WordPress uploads folder. I’m using Xampp on Windows.

  • Xampp puts the htdocs in the applications folder which is write protected. You need to move the htdocs to a writeable folder.

Do I need to keep the plugin activated after the migration?

  • No, you can deactivate or even uninstall the plugin after the migration (for the free version only).

My screen hangs because of a lot of errors in the log window

  • You can stop the log auto-refresh by unselecting the log auto-refresh checkbox

Don’t hesitate to let a comment on the forum or to report bugs if you found some.


Май 31, 2024-ж.
We migrated a very large Drupal 6 website – with over 9,000 pages and almost 200,000 images – to Wordpress. There were a few bumps in the road, but thanks to the plugin’s excellent documentation and Frederic Gilles’ 5-star support, we did it! Thank you, thank you, thank you!!
Апрель 5, 2024-ж.
Migration Drupal 7 to Wordpress with many entities, custom fields, content types and 7000 images worked great.It’s faster than updating from Drupal 7 to Drupal 10! thanks so much for this incredibly good work.
Март 25, 2024-ж.
This plugin is very impressive. It saves so much time and really does an excellent job. I used it on a project from Drupal 7/ubercart to Wordpress/woocommerce and it successfully migrated all the product attributes and options to variations. Customer and orders were also migrated successfully. Compatible with ACF. I highly recommend.
Январь 26, 2024-ж.
Very eager to help with issues I was having importing. Thanks for your help today.Scott Browne
Август 25, 2023-ж.
This plugin does what it’s advertised to do! I’ve used it on several sites. The premium, add-ons are often required to migrate extra types of data – but they are worth it because they work as advertised. The plugin developer responds to support requests and has released plugin updates based upon particular problems I’ve encountered. I highly recommend using the FG Drupal to WordPress plugin(s).
Июль 7, 2023-ж.
We are just using this plugin for a migration and 95% of the features worked fine from the beginning, the other 5% Frédéric really helped fast. In the end it worked perfect and saved a lot of time. Normally I don’t like all this PRO-Plugins with many Addons, in this case I will never regret and rate with 5 stars…
Read all 101 reviews

Contributors & Developers

“FG Drupal to WordPress” is open source software. The following people have contributed to this plugin.




  • Tested with WordPress 6.6


  • Fixed: [ERROR] Error:SQLSTATE[42S22]: Column not found: 1054 Unknown column ‘n.body’ in ‘field list’


  • Fixed: With Drupal 4: Post body was empty
  • Fixed: With Drupal 4: [ERROR] Error:SQLSTATE[42S22]: Column not found: 1054 Unknown column ‘n.body’ in ‘field list’
  • Fixed: With Drupal 4: Warning: Undefined array key “body_value”
  • Tested with WordPress 6.5.4


  • Fixed: Function register_taxonomy was called incorrectly. The “status” taxonomy “name” property (status) conflicts with an existing property on the REST API Posts Controller
  • Tested with WordPress 6.5.3


  • Fixed: Files whose filename is longer than 255 characters were not imported
  • Fixed: Images were not imported by File System method


  • Tested with WordPress 6.5.2


  • Fixed: Pages, ACF post types and other post types not displayed (due to the “order” custom post type)


  • Fixed: Translations missing
  • Fixed: Deprecated: preg_match(): Passing null to parameter #2 ($subject) of type string is deprecated
  • Fixed: Deprecated: strip_tags(): Passing null to parameter #1 ($string) of type string is deprecated
  • Fixed: Deprecated: trim(): Passing null to parameter #1 ($string) of type string is deprecated
  • Tweak: Replace rand() by wp_rand()
  • Tested with WordPress 6.5


  • Tweak: Replace file_get_contents() by wp_remote_get()
  • Tweak: Replace file_get_contents() + json_decode() by wp_json_file_decode()
  • Tweak: Replace json_encode() by wp_json_encode()
  • Tweak: Remove the deprecated argument of get_terms() and wp_count_terms()


  • Fixed: Unsafe SQL calls


  • Fixed: Rename the log file with a random name to avoid a Sensitive Data Exposure


  • Fixed: The media files with absolute path on a Drupal site located in a subdirectory were not imported


  • Tested with WordPress 6.4.3


  • Fixed: Pages not displayed because “year” is a reserved term and can not be used as a taxonomy


  • New: Add the hook “fgd2wp_import_media_filename”
  • New: Add the hook “fgd2wp_process_content_media_links_new_link”


  • New: Don’t import the images in duplicate
  • Fixed: Plugin log can be deleted with a CSRF
  • Fixed: Deprecated: preg_match_all(): Passing null to parameter #2 ($subject) of type string is deprecated


  • New: Check if we need the ECK add-on (Drupal 8)


  • Fixed: Wrong internal links modified
  • Tested with WordPress 6.4.2


  • New: Import the “image” post type as attachment
  • New: Import the duplicate taxonomy terms


  • Update the Help screen


  • Tested with Drupal 10
  • Tested with WordPress 6.4.1


  • Tested with WordPress 6.4


  • Tested with WordPress 6.3.2


  • Fixed: TXT and PPS files were not imported
  • Tested with WordPress 6.3.1


  • New: Check if we need the Book add-on
  • Tested with WordPress 6.3


  • Fixed: “Type” and “terms” are reserved words for taxonomies


  • New: Check if we need the Multifield add-on


  • New: Add many hooks
  • Fixed: FTP connection failed with password containing special characters
  • Tested with WordPress 6.2.2


  • Fixed: Fatal error: Uncaught TypeError: preg_match(): Argument #2 ($subject) must be of type string, array given


  • Fixed: Notice: Function register_taxonomy was called incorrectly. The “content” taxonomy “name” property (content) conflicts with an existing property on the REST API Posts Controller.
  • Tested with WordPress 6.2


  • New: Import the “data-caption” image captions


  • Fixed: Filenames containing % were not imported


  • Fixed: Filenames containing & were not imported


  • New: Compatibility with PHP 8.2


  • Fixed: The option “Import the media with duplicate names” didn’t work anymore (regression from 3.44.0). So wrong images were imported.


  • Tweak: Add the parameter $taxonomy in the hook “fgd2wp_get_node_taxonomies_terms”


  • Fixed: Fatal error: Uncaught ArgumentCountError: Too few arguments to function _post_format_get_terms()
  • Tested with WordPress 6.1.1


  • Tested with WordPress 6.1


  • Tweak: Shorten the filenames if the option “Import the media with duplicate names” is selected
  • Fixed: Some posts had a wrong slug
  • Tested with WordPress 6.0.3


  • New: Add the functions “get_wp_post_ids_from_meta” and “get_wp_term_ids_from_meta”


  • Tested with WordPress 6.0.2


  • Fixed: With PostgreSQL: Warning: unserialize() expects parameter 1 to be string, resource given


  • New: Add the hook “fgd2wp_map_taxonomy”


  • New: Import the image “title” field of the featured images as image caption
  • Tested with WordPress 6.0.1


  • New: Check if we need the ECK add-on


  • Fixed: Page 404 for the posts of type “author”
  • Tweak: Rename the hook “fgd2wp_convert_node_type” to “fgd2wp_map_post_type”


  • Tested with WordPress 6.0


  • New: Add the “language” argument in the function get_node_slug()


  • New: Add the WordPress path in the Debug Info
  • Fixed: the Private key file field was displayed even when FTP is not chosen


  • New: Connection through SFTP using a private key
  • Tested with WordPress 5.9.3


  • Fixed: Missing parent category


  • New: Check if we need the Webform add-on


  • New: Import the audio files in the post content


  • Tweak: Add the function get_post_meta_like()


  • Tweak: Refactor the JavaScript


  • Tested with WordPress 5.9.2


  • Fixed: Don’t check if the CCK add-on is required on Drupal 7


  • New: Don’t delete the theme’s customizations (WP 5.9) when removing all WordPress content
  • Tested with WordPress 5.9


  • New: Add the hook “fgd2wp_get_featured_image”
  • Tested with WordPress 5.8.3


  • Tested with WordPress 5.8.2


  • Fixed: “[ERROR] Not a media” for HTML links


  • New: Import the “post” post types
  • Tested with WordPress 5.8.1


  • Fixed: Images surrounded with a link were not imported in the content


  • New: Add a spinner during the AJAX actions


  • Fixed: Some variables were not escaped before displaying


  • Fixed: Wrong plural terms
  • Tested with WordPress 5.8


  • New: Display the reference of the Drupal entity when a media can’t be downloaded


  • New: Add the hook “fgd2wp_modify_links_in_content”


  • Fixed: Images containing spaces were not replaced in the post content


  • New: Add the hook “fgd2wp_set_plugin_options”
  • Tweak: Refactoring


  • New: Add the “map_taxonomy” function
  • New: Add the “fgd2wp_pre_dispatch” hook
  • Tweak: Rename “convert_node_type” by “map_post_type”


  • New: Add an help tab
  • New: Add a debug info tab


  • Initial version: Import Drupal articles, basic pages, categories, tags and images