Migration playbook · Websites and ecommerce

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.

Updated 4 phases5 detailed steps4 official sources
Start here

Which route should you take for migrating a Joomla or Drupal site to WordPress?

Short answer

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.

Recommended routeWordPress on staging, FG importer plugin, then redirects and domain switch

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.
Order to migrate in, and why

Content first, design second, redirects before launch.

  1. Content and URL inventoryEvery old URL that gets traffic needs a redirect.
  2. WordPress staging siteLets you import and rebuild while the old site stays live.
  3. Import with the FG pluginCopies content, categories, tags and images from the database.
  4. Theme and pluginsTemplates, extensions and modules do not transfer.
  5. Redirects and checksKeeps rankings and links working.
  6. Domain switch and Search ConsoleMoves visitors and search engines to WordPress.
Settings checklist: decide these before you copy

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 WordPress
  • How 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 WordPress
  • How 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 life
  • How 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
The plan, phase by phase
  1. 1

    Inventory and staging

    Week 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.
    Show the detailed steps (1) →
  2. 2

    Import content

    Week 1 to 2

    Watch out: Users, menus and comments need the premium importer.

    Ways around it

    • Recreate them by hand on small sites.
    Show the detailed steps (2) →
  3. 3

    Rebuild

    Weeks 2 to 4

    Watch out: Templates and extensions do not transfer.

    Ways around it

    • Rebuild the design in a WordPress theme.
    Show the detailed steps (2) →
  4. 4

    Redirect and launch

    Launch week

    Watch out: Old URL patterns differ from WordPress permalinks.

    Ways around it

    • Map each old URL in a redirect map.
    Show the detailed steps (2) →
You are finished when
  • 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.
SiteGround web hosting
Click by click

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.

ToolFG Joomla to WordPress or FG Drupal to WordPress plugin
ConnectionReads the old site's database directly
Free versions moveArticles, pages, categories, tags and images
Premium versions addUsers, menus, comments and URL redirects
Drupal 7Security support ended 5 January 2025
Joomla 3.10Support ended 17 August 2023
1What do you need before you migrate a Joomla or Drupal site to WordPress?
NeedDetailsWhere to get it
Old database detailsHost, name, user, password and table prefix.configuration.php (Joomla) or sites/default/settings.php (Drupal)
WordPress staging sitePHP with PDO and PDO_MySQL, and allow_url_fopen on.Your host
Full backup of the old siteFiles and database.Your host
Redirect mapOld URLs to new.The 301 redirect map template
2Prepare the staging site1 step
  1. 1

    Copy the old database

    Where: Your host's database tool or the command line

    Export 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. 1

    Install and configure the plugin

    Where: WordPress admin > Plugins > Add New, then Tools > Import

    Install 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. 2

    Import and check

    Where: The importer screen

    Click 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. 1

    Add redirects

    Where: WordPress redirect plugin or web server

    Add 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. 2

    Switch the domain

    Where: DNS host

    Rerun 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.
Worth knowing

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 effort

Best for: Most Joomla and Drupal sites

  • Reads database directly
  • Can rerun
  • Old site untouched
  • Users, menus and redirects need premium

Manual copy

Medium effort

Best for: Very small sites

  • Clean content
  • Slow

Custom scripts

High effort

Best for: Complex content types

  • Full control
  • Developer time
Our advice

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.

What to do

Treat the move as urgent and limit admin access to the old site meanwhile.

Drupal.org: Drupal 7 end of life
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.

What to do

Consider it only as a bridge while you migrate.

Drupal.org: Drupal 7 end of life
Users and menus may need premiumSaves time

The free FG importers do not move users or menus; their premium versions do.

What to do

Count users and menu items to decide whether to rebuild by hand.

WordPress.org: FG Joomla to WordPress
The import leaves the old site untouchedReduces risk

FG Drupal to WordPress only reads from the Drupal database.

What to do

Keep the old site live until launch, and rerun the import for late content.

WordPress.org: FG Drupal to WordPress
Media copying needs allow_url_fopenSaves time

FG Joomla to WordPress needs PHP's allow_url_fopen on to copy media files.

What to do

Check this with your host before the import.

WordPress.org: FG Joomla to WordPress
Finish safely

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.

CheckHow to checkWhat 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. 1

    Point the domain back

    Where: DNS host

    Restore the old DNS records.

    You should see: The old site loads.
  2. 2

    Fix and retry

    Where: WordPress staging

    Fix 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 database

Cause: Wrong details or remote MySQL blocked.

Fix: Copy the database to the WordPress host and use local details.

Images missing after import

Cause: allow_url_fopen off, or old site unreachable.

Fix: Turn it on and keep the old site online during import.

Old URLs return 404

Cause: No redirects.

Fix: Add redirects from the redirect map.

Users cannot log in

Cause: Users not imported.

Fix: Use the premium importer or create accounts.

Search the full error library →

FAQ

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.

Sources

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 .

Get one practical migration tip a day

Follow Cloud-Migrations.au on LinkedIn or X for deadlines, error fixes, free templates and outage briefs as they happen.