Learn what WPGraphQL is and how to use it with Gatsby and WordPress.
WPGraphQL is a WordPress plugin that adds a GraphQL API to your WordPress site. GraphQL is a query language for requesting information from an API and a protocol for servers that support it. Gatsby uses GraphQL to serve page data. Adding the WPGraphQL plugin to WordPress lets you use GraphQL to retrieve the specific pieces of content that you need to display on a Gatsby page.
You can install WPGraphQL using WordPress’ Add Plugins screen. You may also want to install the WPGraphiQL plugin. WPGraphiQL turns the GraphiQL IDE (or integrated development environment) into a WordPress plugin. You do not have to install WPGraphiQL, but it helps you explore data and create queries from WordPress’ administration interface.
- Download WPGraphQL and WPGraphiQL as ZIP archives from their respective GitHub repositories.
wp-graphiql-master.zipusing the Upload Plugin button on the Add Plugins screen. You’ll have to upload and install them one at a time.
After installing WPGraphQL and WPGraphiQL, you’ll need to activate them. If you’ve used the upload method, WordPress will display an Activate Plugin button on the confirmation screen once the installation process completes. You can also activate (or deactivate) WPGraphQL and WPGraphiQL from the Plugins screen.
Once activated, you may need to update your permalink structure. WPGraphQL requires pretty permalinks, and a custom permalink structure.
Verify that WPGraphQL is working correctly by visiting the
/graphql endpoint, relative to your WordPress home URL. If, for example, your WordPress home URL is
https://www.example.com/blog/, the GraphQL endpoint will be
NOTE: If you are using the
WP_HOMEWordPress constants, WPGraphQL will use the value of
Then you can configure Gatsby to work with your new endpoint.
We recommend using the official gatsby-source-wordpress plugin, which sources data from the WPGraphQL plugin.
You’ll need to do two more things before you can use your WordPress-backed GraphQL server with Gatsby:
- Install the gatsby-source-wordpress plugin; and
gatsby-config.js. Specify the URL of the WPGraphQL endpoint and set other configuration options.
Be sure to restart the development server after making these changes. Now you can use your WordPress GraphQL API with Gatsby just as you would any other GraphQL source.
WPGraphQL is one way to use Gatsby and WordPress together. It adds a flexible GraphQL API to the robust content management features of WordPress.