Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Migrate From Joomla to WordPress

Short answer

Install WordPress, back up your Joomla site, then install the FG Joomla to WordPress plugin and run it from Tools > Import > Joomla (FG). The plugin reads your Joomla database and moves sections, categories, articles, images, media and tags into WordPress. After the import, check your posts, media, links and redirects before you point your domain at WordPress.

Key takeaways

  • FG Joomla to WordPress reads the Joomla database directly, so you do not export a Joomla content file first.
  • The free plugin moves sections, categories, articles, images, media, tags and web links, but not users or menus.
  • Version 4.35.0 of the plugin was updated on 2 October 2026 and lists Joomla 1.5 to 6.0 as tested.
  • Back up both the Joomla files and the Joomla database before you start, because a file-only backup is incomplete.
  • Articles in the Joomla trash are not migrated, while unpublished and archived articles arrive as drafts.
  • Check counts, images, links and redirects after the import, and keep the Joomla site until the checks pass.

What is the fastest way to migrate from Joomla to WordPress?

The fastest route for most sites is the FG Joomla to WordPress plugin, which reads your Joomla database and imports the content into WordPress.

You install WordPress first, back up Joomla, then run the importer from Tools > Import > Joomla (FG). The plugin page on WordPress.org says it migrates sections, categories, posts, images, media and tags from Joomla to WordPress.

This route suits article sites, blogs and small business sites. If your Joomla site relies on a shop, a forum or a booking system, plan extra time to rebuild those parts in WordPress. A side-by-side look at the two systems can help you decide what to rebuild, as in WordPress vs Joomla.

What does FG Joomla to WordPress move, and what does it leave behind?

The free plugin moves sections, categories, articles, images, media, tags and web links, while users, menus and most extension data stay behind.

WordPress.org lists the free features on the FG Joomla to WordPress plugin page. It turns Joomla sections into categories, categories into sub-categories, and articles into posts or pages. It also keeps image alt text and captions, and it can set the first post image as the featured image.

The paid Premium edition adds the parts the free plugin skips. The same plugin page says Premium migrates authors and other users with their passwords, plus navigation menus, meta descriptions and meta keywords. Premium also adds Joomla 3.7 and later custom fields, Joomla 3.1 and later tags, and Joomla 2.5 and later featured images.

ContentFree pluginPremium edition
Articles, categories and tagsYesYes
Images and other mediaYesYes
Web linksYesYes
Authors and users with passwordsNoYes
Navigation menusNoYes
Meta descriptions and keywordsNoYes
Custom fields from Joomla 3.7 and laterNoYes

Extension content needs a separate plan. The plugin page lists paid add-ons for K2, EasyBlog, Flexicontent, Kunena, Virtuemart and others, sold on the author's site. Check each add-on before you promise a date for that content.

What do you need before you start?

You need a working WordPress install, access to the Joomla database details, and a full backup of the Joomla site.

The Joomla database details live in the Joomla configuration.php file. The FG Joomla to WordPress plugin page maps each value for you: hostname comes from $host, database from $db, username from $user, password from $password, and table prefix from $dbprefix.

The standard MySQL port is 3306, according to the same page.

Check the WordPress host too. WordPress.org recommends PHP 8.3 or greater, MariaDB 10.11 or greater or MySQL 8.4 or greater, and HTTPS support, as of November 2026. Older PHP 7.4 and MySQL 5.5.5 setups still run WordPress, but WordPress.org notes those versions have reached end of life.

You also need the Joomla home page URL for the media settings. The plugin FAQ says the URL field must be your Joomla home page URL and must start with http:// or https://. A wrong URL is a common reason media fail to import.

How do you back up your Joomla site first?

Back up the Joomla files and the Joomla database together, then store a copy away from the live server.

Joomla documentation states that a backup has two parts: the database and the files and folders on the site. The Joomla backup guide warns that if you do not back up your files and database, your backup is incomplete.

Akeeba Backup is the method that guide calls the common method. It produces a .jpa file that holds all the site files and the database content, plus an installer, and its kickstart.php file unpacks the archive.

The guide also describes a manual route: export the database in phpMyAdmin and download the files by FTP or from the host file manager.

Joomla documentation recommends backing up the database at least twice per week, or every day for an active site. Do the backup right before the migration, not a week earlier, so no new article is lost.

How do you set up WordPress for the move?

Install a fresh WordPress site on the same host or a staging host, then install FG Joomla to WordPress on it.

A fresh install keeps the import clean. The plugin can import Joomla articles as posts or pages, so decide which shape fits your site before you run it. If you need a full-site copy method instead, see how to migrate WordPress manually.

Install the plugin from Plugins > Add New, or upload its zip file there. The plugin page gives the same install path: Admin > Plugins > Add New > Upload, then Install Now and Activate.

Version 4.35.0 is the latest version listed on WordPress.org, updated on 2 October 2026. The same page gives the plugin a rating of 4.7 out of 5 from 337 reviews, as of November 2026. Version 4.34.0 added PHP 8.5 support and listed Joomla 6.0 as tested, and version 4.34.1 listed WordPress 7.1 as tested.

How do you run FG Joomla to WordPress step by step?

Run the importer from Tools > Import > Joomla (FG), enter the Joomla database details, choose your media options, then start the import.

  1. Open your WordPress dashboard and go to Tools > Import > Joomla (FG).
  2. Enter the Joomla database hostname, port, database name, username, password and table prefix from configuration.php.
  3. Enter your Joomla home page URL in the URL field.
  4. Choose whether to import media into the WordPress uploads folders and whether to import external media.
  5. Choose whether Joomla articles become posts or pages.
  6. Click the import button and watch the log for errors.

The plugin reads the Joomla database and does not change it. Its FAQ states that the migration process does not modify the Joomla site it migrates from, because it only reads the Joomla database.

If the two sites sit on different hosts, the WordPress server must reach the Joomla database. The plugin FAQ suggests allowing a remote MySQL connection in the Joomla host control panel, or copying the Joomla database onto the WordPress database server first and using the WordPress database details instead.

How do you move media, menus, and users?

Media move with the free plugin when the URL and server settings are right, while menus and users need the Premium edition or manual work.

For media, the plugin uploads post media to the WordPress uploads folders as an option, resizes images to the sizes defined in WordPress, and updates post content to keep the media links. Those steps are listed on the FG Joomla to WordPress plugin page.

If media do not import, check two server settings first. The plugin FAQ says the PHP directive allow_url_fopen must be turned on in php.ini to copy media, and that you may need to run the migration on a local copy if your host does not allow it.

For users and menus, the free plugin has no path. The Premium edition migrates authors and other users with their passwords and migrates navigation menus, according to the same plugin page.

If you stay on the free plugin, create the WordPress users by hand and rebuild each menu, then assign the imported posts to the right authors.

How do you check the migration worked?

Compare article counts, category counts, images and links between the Joomla site and the WordPress site before you switch anything.

Start with counts. Count published, unpublished and archived articles in Joomla, then count posts and drafts in WordPress. The plugin FAQ says posts in the trash are not migrated, but unpublished and archived posts are migrated as drafts, so expect drafts where Joomla had unpublished work.

Open a sample of posts from each category. Check the text, the first image, the featured image, captions and internal links.

The plugin modifies internal links during the import, but a sample check still catches links that point at old Joomla paths. For link problems after a move, see fix broken links after migration.

Check the media library next. Look for missing images, images with the wrong file, and files that share a name. The plugin page notes that it can import media with duplicate names, so check posts where two images shared a file name.

Set up redirects from old Joomla URLs to the new WordPress URLs before you change the domain. The Premium edition can keep Joomla article IDs or redirect Joomla URLs to the new WordPress URLs, according to the plugin page.

Point the domain only after the redirects are in place, as described in how to point a domain to WordPress hosting.

What if the import stops or media are missing?

A stopped import can often resume where it left off, while missing media usually point to a URL or server setting.

The plugin FAQ says you can run the migration again and it will continue where it stopped. It also suggests deactivating all WordPress plugins except the ones used for the migration before you retry.

Memory errors are a known cause of a stop. The FAQ suggests adding define('WP_MEMORY_LIMIT', '512M'); to wp-config.php, or raising the memory limit in php.ini to 1G if you have access to that file.

The WordPress Importer page describes the same symptom for large files: a message like “Fatal error: Allowed memory size of 8388608 bytes exhausted” means the script hit the host PHP memory limit.

The plugin needs PDO and PDO_MySQL libraries, according to its FAQ. A “Fatal error: Class 'PDO' not found” message means those libraries are not enabled in php.ini on the WordPress host.

Turn on logging if the cause is still unclear. The FAQ says a log file has existed since version 1.45.0, and that setting WP_DEBUG and WP_DEBUG_LOG to true in wp-config.php writes messages to wp-content/debug.log.

What mistakes should you avoid?

Do not delete the Joomla site, skip the backup, or re-run a failed import without checking for duplicates first.

A failed import may still create some content. The WordPress importing guide warns that when you resolve the error and try again, you may create duplicate data, so review your site after a failed import and remove records as needed.

Do not use the WordPress Importer for the Joomla content itself. That plugin imports posts, pages, comments, custom fields, categories, tags and authors from a WordPress export file, according to the WordPress Importer page.

Version 0.9.7 is the latest version listed there, updated on 20 October 2026, with a rating of 3.1 out of 5 from 326 reviews.

The WordPress Importer fits a different job: moving content between two WordPress sites. The developer guide to importing content points Joomla users to FG Joomla to WordPress instead.

That guide notes the plugin had been tested with Joomla versions 1.5 through 4.0, while the plugin page now lists Joomla 1.5 to 6.0 as tested, as of November 2026.

Keep the Joomla site live until the WordPress site passes its checks. If you need a different full-site method later, the Duplicator route is one option, covered in how to migrate WordPress with Duplicator.

For a file-based move between WordPress sites, see how to migrate with All-in-One WP Migration.

Frequently asked questions

Can I migrate from Joomla to WordPress without a plugin?

You can move articles by hand, but there is no built-in Joomla export that produces a WordPress import file. The usual no-plugin path is to export the Joomla database and rebuild the content, which is slow and error prone. For most sites, the FG Joomla to WordPress plugin is the shorter and safer route.

Does FG Joomla to WordPress change my Joomla site?

No. The plugin only reads the Joomla database and does not change the Joomla site. Your Joomla site stays live and unchanged while the import runs. Keep it live until you have checked the WordPress copy, so you can compare the two sites and re-run the import if something is missing.

Will my Joomla users and passwords move to WordPress?

Not with the free plugin. User and author migration, with passwords, is a Premium feature, along with navigation menus and meta descriptions. If you use the free plugin, create the WordPress user accounts by hand and ask each author to set a new password, then assign their imported posts to them.

What happens to my Joomla URLs after migration?

WordPress creates its own URLs, so old Joomla URLs can break unless you redirect them. Set up redirects from each old Joomla URL to the matching new WordPress URL before you point the domain at WordPress. The Premium edition can keep Joomla article IDs or redirect Joomla URLs to the new WordPress URLs.

How long does a Joomla to WordPress migration take?

It depends on the number of articles, the size of the media library, and the speed of the two servers. A small site with a few dozen articles can finish in under an hour, while a large site with thousands of articles and many images can take several hours. Run it on a staging copy first to learn how long your site needs.

Can I run the migration again if some articles are missing?

Yes. The plugin FAQ says you can run the migration again and it will continue where it stopped. Check first whether the missing articles were in the Joomla trash, because trashed articles are not migrated. Also check for a memory error or a database connection error in the log before you retry.

Sources

  1. FG Joomla to WordPress WordPress.org
  2. WordPress Importer WordPress.org
  3. Importing Content Developer.WordPress.org
  4. Requirements WordPress.org
  5. Backup Basics for a Joomla! Web Site Joomla! Documentation
  6. FG Joomla to WordPress Frederic Gilles

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test