Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

Installation & Getting Started 🐤

If you've had previous experience with Gatsby or you like to move fast, you can use the quick start steps below to get up and running quickly. If you'd like to take a step back and learn more first, head over to our tutorials 👣

Quick start

  1. Install Node, Gatsby, and gatsby-cli

  2. Install a starter gatsby new my-wordpress-gatsby-site

  3. Install and activate both of the following plugins in a live WordPress instance.

  4. In the gatsby-config.js of the starter you just set up, update the plugin options for gatsby-source-wordpress. Change the url option so that it points to your WordPress instance GraphQL url. This should be the full url of your GraphQL endpoint. E.g.

  5. Run gatsby develop and experience the magic 🌟

  6. Create your beautiful and accessible app 💅

  7. Build with Gatsby Cloud & deploy to Netlify for a fast, wonderful, and affordable CI/CD experience 💥 🚀

Hot tip

For a fast, easy, and reliable WordPress local dev server, use Local by Flywheel. This will save you time setting up WordPress on your computer and you can easily push and pull to and from Flywheel/WPEngine hosting!

Required WordPress Dependencies

In addition to WordPress, there are 2 other required plugins on the PHP side of things. If you're on the latest version of the source plugin and these plugins, everything will work great. If there is a version mismatch, you'll be notified and provided a download link for the correct versions in your terminal via our compatibility API when you run a build 😄


This plugin turns your WordPress instance into a GraphQL server.


This plugin modifies the WPGraphQL schema in Gatsby-specific ways and also keeps a record of when user actions happened. This allows us to do selective cache invalidation in Gatsby (to speed up builds) and add Preview support.


Please note that we only officially support the latest version of WordPress. However, WordPress is great at keeping backwards compatibility and older versions may work.

Up Next 👉