Migrate from WordPress to a headless CMS in 3 easy steps
Tags: wordpress, headlesscms, api
Published: 2023-08-16 17:17:00

---
title: Migrate from WordPress to a headless CMS in 3 easy steps
published: true
description: Migrate from WordPress to a headless CMS in 3 easy steps.
tags: WordPress, headlessCMS, API
cover_image: https://imgix.cosmicjs.com/c10cff80-2af6-11ee-a3b3-4b236860edf1-Wordpress-Importer.png
published_at: 2023-08-16 17:17 +0000
canonical_url: https://www.cosmicjs.com/blog/migrate-from-wordpress-to-a-headless-cms-in-3-easy-steps
---

In this article I'm going to show you how to migrate from WordPress to a headless CMS in 3 easy steps. To make this quick and simple, we will be using the [Cosmic WordPress Importer extension](https://www.cosmicjs.com/marketplace/extensions/wordpress-importer) to import posts using any available WordPress RSS feed. 

This article assumes that you already have at least a cursory knowledge of both WordPress and headless CMS. If you don't understand these concepts, I recommend you [learn about headless CMS](https://www.cosmicjs.com/headless-cms) and check out the [WordPress vs Headless CMS comparison page](https://www.cosmicjs.com/compare/wordpress).

### TL;DR
[Sign up for Cosmic](https://app.cosmicjs.com/signup)

[Install the WordPress extension](https://www.cosmicjs.com/marketplace/extensions/wordpress-importer)

[View the source code to see how the extension is built](https://github.com/cosmicjs/cosmic-wordpress-importer)

### WordPress fanboys need not apply
WordPress powers about [40% of the web](https://colorlib.com/wp/wordpress-statistics/). That's a lot of websites that are suffering from the same [problems](https://www.wpbeginner.com/common-wordpress-errors-and-how-to-fix-them/). Some people love WordPress, this article is not for them.

This article is for people who are fed up with the issues that come with one of the world's most popular content management systems and are ready to go headless. If this applies to you, let's get started.

### 1. Create a new Cosmic project
First create a free [Cosmic account](https://app.cosmicjs.com/signup) then set up a new project.
![Cosmic Project](https://imgix.cosmicjs.com/2dc64900-effc-11ed-985a-3383d9405b5e-create-project.png?auto=format,compression&w=1200)

### 2. Install the Extension
Go to the Extensions tab then find the Cosmic WordPress Importer extension and install it.
![extension.png](https://imgix.cosmicjs.com/87a9eed0-3ad5-11ee-82b2-d53af1858037-extension.png?auto=format,compression&w=1500)


### 3. Migrate your content
After you install the extension, you will be asked to add a feed URL to import the posts. A feed URL is any publicly available WordPress RSS feed (something like [https://github.blog/feed](https://github.blog/feed)).

Select how may posts you want to install and click "Submit".  Automatically, the WordPress posts will populate into Cosmic. Refresh the page to see links to the posts available in Cosmic.

Your posts are now available via a simple API endpoint. The JSON data payload will look something like this:
```json
{
  "objects": [
    {
      "slug": "angels-who-help-you-fly",
      "title": "Angels who help you fly",
      "metadata": {
        "content": "<p>Paddling out at Pacifica Beach on an unusually warm, beautiful day, I noticed a...",
        "snippet": "Paddling out at Pacifica Beach on an unusually warm, beautiful day, I noticed a guy...",
        "author": "Jane Mariechen",
        "categories": "Surfing, California"
      }
    },
    {
      "slug": "trust-yourself",
      "title": "Trust yourself",
      "metadata": {
        "content": "<p>I sat on the sidelines with anxiety as I watched the...",
        "snippet": "I sat on the sidelines with anxiety as I watched the big waves from a distance....",
        "author": "John Marieche",
        "categories": "Surfing, Hawaii"
      }
    }
  ]
}
```

You can now deliver your content to any website or application. FREEDOM!
![freedom.gif](https://imgix.cosmicjs.com/f60489f0-3709-11ee-82b2-d53af1858037-freedom.gif)


### Bonus points
Luckily, the Cosmic WordPress Importer extension code is available [open source](https://github.com/cosmicjs/cosmic-wordpress-importer) so you can customize the data that it pulls in. You can also learn how to [build your own Cosmic extension](https://www.cosmicjs.com/docs/dashboard/buckets#extensions).

### Conclusion
I hope you found this article helpful. [Sign up for Cosmic](https://app.cosmicjs.com/signup) and reach out to  [Cosmic support](https://www.cosmicjs.com/contact) if you have any questions or need dedicated migration support.