WordPress is one of the most adaptable and flexible content management systems (CMSs) around. Nearly 40 percent of websites run on the platform. WordPress is so functional that it can operate headlessly. Don’t worry, it’s not as spooky as it sounds.

Headless WordPress sites allow you to use the familiar WordPress tools for managing your content while decoupling it from the rest of your front end so you can operate the site as you need it to work while still getting WordPress’s trusty CMS.

  • What’s a headless WordPress site?
  • What are the pros and cons of using a headless WordPress site?
  • How to set up a headless WordPress site

What’s a Headless WordPress Site?

First things first, it’s worth acknowledging that WordPress is a powerful and often useful tool for website creation. Its CMS is unmatched, a reliable and easy-to-use tool for all of your content-related needs.

But when it comes to building the rest of your site, it can be a little lacking. WordPress is customizable, but it’s a little restricted because of its reliance on themes. There are lots of WordPress themes out there that will help you get some structure and functionality, but it’s a bit limited to what has been done before.

Unless you want to shell out a lot of time or money to get a custom-built theme, bootstrapping your website with WordPress can be like trying to fit a square peg in a round hole.

Source: 10Clouds

This is where a headless WordPress site can come in handy. A headless WordPress site is an extension of a headless CMS, which is a CMS that has been separated from its typical architecture.

A CMS is your back end and it’s usually paired with a front end — the part that visitors to your website see — designed to work with it, but a headless CMS allows you to keep the familiar back end but accesses it through an application programming interface (API) or software development kit (SDK). This allows you to build a fully custom site that serves your needs while keeping a CMS that’s functional and familiar.

A headless WordPress site specifically lets you keep the WordPress back end and operate it with your site. WordPress developers created the Rest API back in 2016 to enable this.

Through this API, you won’t get to use the “What You See Is What You Get” (WYSIWYG) editor that allows you to preview how the content will look on your site, but you’ll be able to use the same back-end functionality for creating and managing content. Many WordPress themes are made to be compatible with headless WordPress.

What Are the Pros and Cons of Using a Headless WordPress Site?

There are benefits and downsides to using a headless WordPress site. Because WordPress is so familiar, it can be difficult to imagine what it would be like to operate a site without the front end. But it’s worth considering if your site would be better served by using a headless WordPress and a front end that’s more friendly for developers to work with.

Headless WordPress Site
Source: SITE123


  1. More flexibility: While WordPress is well known for being an extremely flexible platform, this becomes exponentially true with a headless WordPress. You’re no longer restricted to the WordPress front end and can enjoy the freedom of building your own site with the tools that are more functional for what you need, all while keeping the WordPress back end for your publishing needs.
  2. Better security: WordPress is secure but does open up the possibility for a security threat because your site is hosted on a database that must be contacted every time someone visits it. A headless WordPress lets you use a static site generator that has no active web server and cuts out the possibility of certain cyberattacks like distributed denial of service (DDoS) or malicious server requests.
  3. Improved performance: Headless WordPress sites can cut down on some of the less responsive parts of the WordPress front end and can be streamlined considerably. This means your site will run faster, load quicker, and be easier for people to access and navigate. It may be a matter of milliseconds in practice, but if your site has lots of visitors and can handle that traffic smoother, it’ll make a major difference.
  4. Easy to set up: Thanks to the Rest API, it can be very easy for your development team to set up a headless WordPress. Even if you’re handling things on your own, if you have a little bit of experience with front-end development and implementing APIs, you’ll be able to integrate Rest API quickly and easily into your site and enjoy the WordPress back end with your ideal front-end option.


  1. More complicated coding: While setting up a headless WordPress is pretty straightforward, especially if you have a development team, it can be a little complicated for a beginner with limited website building experience. Sticking with a standard WordPress site might limit your functionality a little bit, but it also will eliminate a lot of headaches if you aren’t sure what you’re doing.
  2. Worse for publishing lots of content: For some sites, publishing content is secondary or a tool for improving SEO. For others, it’s the primary goal of the site to produce consistent content. If that’s the case, relegating WordPress to the back end may not be ideal. You want to be able to utilize the full CMS, and it may be better to keep it intact rather than separate it from the front end. If you’re focusing on publishing content, the CMS is the most important feature.

How to Set Up a Headless WordPress Site

Setting up a headless WordPress site varies, depending on your site and what you’re hoping to accomplish, but here’s a simple guide to the basic framework for setting up your headless WordPress site:

wordpress blog
Source: Squarespace
  • Download the Rest API: WordPress provides a download of the popular Rest API that you can access any time you want from GitHub.
  • Upload the Rest API to your WordPress plug-ins folder: You’ll need to put the Rest API in the same folder that you put your other plug-ins in order to activate and operate it.
  • Activate Rest API: Rest API should show up on your WordPress site with the other plug-ins that you have installed. Make sure it’s active so that you can start using it.
  • Direct the permalinks: Open the Settings menu, click on Permalinks, and select either Custom Structure or Post Name. Set your permalink to direct to your site where you want the content to appear.
  • Install Custom Post Type UI plug-in: You’ll need to download and install the Custom Post Type UI plug-in by dragging it to your plug-ins folder. Once there, you’ll be able to make posts on your Headless WordPress site.
  • Create a new post: Once you have activated the Custom Post Type UI, you can start creating your content. Make sure the checkbox for Rest API is set for “True” and it should appear on your site.


A headless WordPress site provides additional functionality and flexibility for your website front end while allowing you to enjoy the reliable WordPress CMS. If you’re looking for more customization for your website, a headless WordPress site is an option that both your content team and development team will appreciate.

Related Software and Services