How to migrate a Joomla or Drupal site to WordPress
An importer plugin in WordPress reads the old Joomla or Drupal database directly and copies content, categories, tags and images. Build on a staging site, rebuild the design and extensions, add redirects for every old URL, then switch the domain.
Which route should you take for migrating a Joomla or Drupal site to WordPress?
This moves a website built on Joomla or Drupal to WordPress. You set up WordPress on a staging address, install a plugin that reads the old site's database and copies the articles, pages, categories and images across, then rebuild the design and features.
- Recommended route: WordPress on staging, FG importer plugin, then redirects and domain switch
- Order: Content first, design second, redirects before launch.
- 4 phases: Inventory and staging, Import content, Rebuild and Redirect and launch.
- You're done when: All content is in WordPress and checked.
Before switching, you add redirects so every old page address leads to its new one. Then you point the domain at WordPress.
The importer copies content straight from the database, leaves the old site untouched and can be rerun.
Other options and when to use them
- Manual copy and paste: Sites with a few dozen pages.
- Developer-built migration scripts: Complex custom content types or very large sites.
Content first, design second, redirects before launch.
- Content and URL inventoryEvery old URL that gets traffic needs a redirect.
- WordPress staging siteLets you import and rebuild while the old site stays live.
- Import with the FG pluginCopies content, categories, tags and images from the database.
- Theme and pluginsTemplates, extensions and modules do not transfer.
- Redirects and checksKeeps rankings and links working.
- Domain switch and Search ConsoleMoves visitors and search engines to WordPress.
Built-in and third-party tools treat these differently. Tick each one off once you have decided.
Download this checklist (Excel)How each tool handles it
Built-in methodWordPress has no built-in Joomla or Drupal importer.FG Joomla to WordPressFree: sections, categories, posts, images, media and tags. Premium: users with passwords, menus, URL redirects and add-ons such as K2 and JComments. Tested with Joomla 1.5 to 6.0.FG Drupal to WordPressFree: articles, basic pages, categories, tags and images. Premium: comments, users, custom fields, menus and URL redirects. Tested with Drupal 4 to 11.Tip: Run the free version on staging first to see how much else you need.
WordPress.org: FG Joomla to WordPressHow each tool handles it
Built-in methodBoth importers connect to the old database with the details in Joomla's configuration.php or Drupal's sites/default/settings.php.FG Joomla to WordPressNeeds remote MySQL access between hosts, or a copy of the Joomla database on the WordPress host; PDO and PDO_MySQL enabled.Tip: Copy the old database to the WordPress host to avoid opening remote MySQL access.
WordPress.org: FG Drupal to WordPressHow each tool handles it
Built-in methodDrupal 7 security support ended on 5 January 2025. Joomla 3.10 support ended on 17 August 2023.Tip: Lock down admin access on the old site while the project runs.
Drupal.org: Drupal 7 end of lifeHow each tool handles it
Built-in methodWordPress: redirects are added with a plugin or at the web server.FG Joomla to WordPressPremium redirects Joomla URLs to the new WordPress URLs.FG Drupal to WordPressPremium redirects Drupal URLs to the new WordPress URLs.Tip: Export your top landing pages from analytics and test each one.
WordPress.org: FG Drupal to WordPress
- 1
Inventory and staging
Week 1Show the detailed steps (1) →Watch out: Remote database access may be blocked between hosts.
Ways around it
- Import a copy of the old database on the WordPress host.
- 2
Import content
Week 1 to 2Show the detailed steps (2) →Watch out: Users, menus and comments need the premium importer.
Ways around it
- Recreate them by hand on small sites.
- 3
Rebuild
Weeks 2 to 4Show the detailed steps (2) →Watch out: Templates and extensions do not transfer.
Ways around it
- Rebuild the design in a WordPress theme.
- 4
Redirect and launch
Launch weekShow the detailed steps (2) →Watch out: Old URL patterns differ from WordPress permalinks.
Ways around it
- Map each old URL in a redirect map.
- All content is in WordPress and checked.
- Every old URL with traffic redirects to its new page.
- The domain points to WordPress and the sitemap is submitted.
- The old site is archived and switched off.
What does each step of migrating a Joomla or Drupal site to WordPress involve?
Open a part when you reach it in the plan. Each step says where to go, what to do and what you should see.
About this migrationWhat it covers, limits at a glance
Many Joomla 3 and Drupal 7 sites are now running without security support. Moving to WordPress means copying content out of the old database, rebuilding the design as a WordPress theme, replacing extensions or modules with plugins and redirecting old URLs so search engines and bookmarks follow.
Both importers are plugins in the WordPress directory and read the old database without changing the old site. Moving a WordPress site between hosts instead? See WordPress migration.
1What do you need before you migrate a Joomla or Drupal site to WordPress?
| Need | Details | Where to get it |
|---|---|---|
| Old database details | Host, name, user, password and table prefix. | configuration.php (Joomla) or sites/default/settings.php (Drupal) |
| WordPress staging site | PHP with PDO and PDO_MySQL, and allow_url_fopen on. | Your host |
| Full backup of the old site | Files and database. | Your host |
| Redirect map | Old URLs to new. | The 301 redirect map template |
2Prepare the staging site1 step
- 1
Copy the old database
Where: Your host's database tool or the command lineExport the old database and import it into a new database on the WordPress host. See export and import a MySQL database.
You should see: The old database is reachable from WordPress.
3Run the importer2 steps
- 1
Install and configure the plugin
Where: WordPress admin > Plugins > Add New, then Tools > ImportInstall FG Joomla to WordPress or FG Drupal to WordPress, open its importer, enter the database details and table prefix, and test the connection.
You should see: The connection test succeeds. - 2
Import and check
Where: The importer screenClick Start / Resume the import in the importer. Then check a sample of posts, pages, categories and images against the old site.
You should see: Content and images appear in WordPress.
4Redirect and launch2 steps
- 1
Add redirects
Where: WordPress redirect plugin or web serverAdd redirects from every old URL. See set up 301 redirects and test with a hosts file.
You should see: Old URLs return 301 to the new pages. - 2
Switch the domain
Where: DNS hostRerun the import for recent content, point the domain at WordPress, update the site address and submit the sitemap. Follow the website launch checklist.
You should see: The domain serves WordPress.
What can go wrong when migrating a Joomla or Drupal site to WordPress, and how do you avoid it?
The detail behind the plan: options compared, and what experienced engineers check first. Tap any item.
Compare all the ways to do this3 options
FG importer plugin
Low effortBest for: Most Joomla and Drupal sites
- Reads database directly
- Can rerun
- Old site untouched
- Users, menus and redirects need premium
Manual copy
Medium effortBest for: Very small sites
- Clean content
- Slow
Custom scripts
High effortBest for: Complex content types
- Full control
- Developer time
Use the FG importer for your platform on a staging site. Decide on the premium version once you see what the free import leaves out.
The old site may be unsupportedReduces risk
Drupal 7 security support ended on 5 January 2025, and Joomla 3.10 support ended on 17 August 2023.
Treat the move as urgent and limit admin access to the old site meanwhile.
Extended support is an option for Drupal 7Cost lever
The Drupal Association runs an Extended Security Support Provider Program for Drupal 7 sites that cannot migrate in time.
Consider it only as a bridge while you migrate.
Users and menus may need premiumSaves time
The free FG importers do not move users or menus; their premium versions do.
Count users and menu items to decide whether to rebuild by hand.
The import leaves the old site untouchedReduces risk
FG Drupal to WordPress only reads from the Drupal database.
Keep the old site live until launch, and rerun the import for late content.
Media copying needs allow_url_fopenSaves time
FG Joomla to WordPress needs PHP's allow_url_fopen on to copy media files.
Check this with your host before the import.
How do you check it worked after migrating a Joomla or Drupal site to WordPress, or roll back?
Full validation checklist4 checks
Run these before you declare the migration complete. Record the results in the data validation report.
| Check | How to check | What good looks like |
|---|---|---|
| Content counts | Compare articles and pages in old and new. | They match. |
| Images | Open a sample of pages. | No broken images. |
| Redirects | Test top URLs. | 301 to the right page. |
| Search Console | Watch 404s after launch. | No rise in errors for important pages. |
Rollback planIf it goes wrong
Roll back if
- Key pages broken after launch
- Search traffic drops sharply from missing redirects
Point of no return
The old site is unchanged. Until you delete it, rollback is pointing the domain back.
- 1
Point the domain back
Where: DNS hostRestore the old DNS records.
You should see: The old site loads. - 2
Fix and retry
Where: WordPress stagingFix redirects or content, then relaunch.
You should see: A clean relaunch.
Agree the triggers and who decides before the go / no-go meeting. Use the rollback plan template.
Common problems and fixes4 errors
Importer cannot connect to the databaseCause: Wrong details or remote MySQL blocked.
Fix: Copy the database to the WordPress host and use local details.
Images missing after importCause: allow_url_fopen off, or old site unreachable.
Fix: Turn it on and keep the old site online during import.
Old URLs return 404Cause: No redirects.
Fix: Add redirects from the redirect map.
Users cannot log inCause: Users not imported.
Fix: Use the premium importer or create accounts.
Questions about migrating a Joomla or Drupal site to WordPress
Does WordPress import Joomla or Drupal on its own?
No. Use an importer plugin such as FG Joomla to WordPress or FG Drupal to WordPress.
Will my design move?
No. Rebuild it in a WordPress theme.
Does the import change the old site?
No. It reads the old database.
Which Drupal versions work?
FG Drupal to WordPress lists Drupal 4 to 11 as tested.
Official sources for migrating a Joomla or Drupal site to WordPress
4 official pages this guide is based on
Vendors change limits and features, so confirm details on the source before you rely on them. Last checked .

