> ## Documentation Index
> Fetch the complete documentation index at: https://ghost-fabien-hkg-1948-document-built-in-s3-storage-adapter.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from WordPress

> Migrate from WordPress and import your content to Ghost with this guide

You can easily migrate your posts and pages from WordPress site to Ghost in just a few clicks, using the WordPress migrator in Ghost Admin.

## **Run the migration**

The WordPress migrator allows you to quickly import content from your WordPress site to your Ghost publication. You can access the migrator tool from the **Settings → Advanced →** **Import/Export** area of Ghost Admin.

<img src="https://mintcdn.com/ghost-fabien-hkg-1948-document-built-in-s3-storage-adapter/QvplxVP9HRDZCGwF/images/migrate-tools-apr-2026.png?fit=max&auto=format&n=QvplxVP9HRDZCGwF&q=85&s=2448da95cae8140e92c5f4e476dcd82e" alt="The in app Migrate Tools" width="1308" height="686" data-path="images/migrate-tools-apr-2026.png" />

It's helpful to log in to your WordPress site before running the migration in Ghost Admin.

### **1. Enter your WordPress URL**

To start the migration process, enter the public URL to your WordPress site, and click **Continue**.

<img src="https://mintcdn.com/ghost-fabien-hkg-1948-document-built-in-s3-storage-adapter/-8bBqSlFdouyATdr/images/1.png?fit=max&auto=format&n=-8bBqSlFdouyATdr&q=85&s=f00aee60e36c6a3070a49119a6dbf8fe" alt="1.png" width="1000" height="795" data-path="images/1.png" />

### **2. Export content**

Next, click **Open WordPress Settings.** If already logged into WordPress, this will take you directly to the location of your WordPress site where an export can be generated.

<img src="https://mintcdn.com/ghost-fabien-hkg-1948-document-built-in-s3-storage-adapter/-8bBqSlFdouyATdr/images/2.png?fit=max&auto=format&n=-8bBqSlFdouyATdr&q=85&s=188322e678ce5e44b8cc859bf24aaa59" alt="2.png" width="1000" height="1302" data-path="images/2.png" />

Select **All content,** click **Download Export File**, which will download an XML file with your content in it.

### **3. Upload content**

Once your export has been downloaded, return to the migrator window in Ghost Admin, and select **Click or drag file here to upload**, and navigate to the XML file you downloaded from WordPress, once uploaded click **Continue**.

If you're unsure of where the file was saved, check your Downloads folder.

### **4. Review**

Ghost will confirm the number of posts and pages that will be imported to your publication. If satisfied, click **Import content** to begin the import of your data.

<img src="https://mintcdn.com/ghost-fabien-hkg-1948-document-built-in-s3-storage-adapter/-8bBqSlFdouyATdr/images/3.png?fit=max&auto=format&n=-8bBqSlFdouyATdr&q=85&s=315b4d188400f7a7b48d1ed1092284a2" alt="3.png" width="1000" height="886" data-path="images/3.png" />

After a few moments, you'll see a confirmation message, confirming that your data was successfully migrated to your Ghost site.

### Supported Content

What is supported:

* XML files up to 100mb
* Up to 2,500 posts
* Some shortcodes, such as `[caption]`, `[audio]`, `[code]`, along with most `[vc_]` & `[et_]` based shortcodes from page builder plugins.

What's not supported:

* Custom post types
* Most uncommon shortcodes
* Plugins that alter access to content

***

### **Redirects**

<Info>
  ℹ️ WordPress categories are converted to [tags](https://ghost.org/help/tags/) during the migration. The first category for any post will also become the [primary tag](https://ghost.org/help/tags/#primary-tags).
</Info>

You may need to add redirects to ensure backlinks lead to the correct content.

Please refer to this list of the [most common redirection rules for WordPress migrations](https://ghost.org/tutorials/implementing-redirects/#common-redirects).

## **Large and Complex migrations**

If your migration needs go beyond what our in-built migration tools can support you can still move to Ghost.

If you're a **Ghost(Pro) customer**, our Migrations team can support you in migrating your content and subscribers. Learn more and get in touch with the team [here](https://ghost.org/concierge/).

Alternatively, if you are a developer, comfortable with using the command line, or running a self-hosted Ghost instance, we have a suite of[ open-source migration tools ](https://github.com/TryGhost/migrate)to help with large, complex and custom migrations.