Skip to main content


Before You Begin

This guide is for common troubleshooting tips when developing with the @pantheon-systems/gatsby-wordpress-starter. For information on troubleshooting on Pantheon, see Pantheon Front-End Sites Frequently Asked Questions.

gatsby-source-wordpress Fails To Fetch Data From WordPress

There are a few possible reasons for this:

  1. The WP GraphQL plugin in WordPress has not been activated

  2. The WP Gatsby plugin in WordPress has not been activated

    Solution: activate the plugin

  3. The gatsby-source-plugin fails with the following error:

    Error: getaddrinfo ENOTFOUND
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (node:dns:71:26)

    Error occurred while fetching non-Node root fields.

    Solution: Check that the WordPress site it active and try the command again. Ensure both the WP GraphQL and WP Gatsby plugins are activated.

WordPress Server Overloaded

Rarely, the gatsby-source-wordpress server complains of an overloaded WordPress server. If you are experiencing this issue frequently, it is recommended to add the following options to the gatsby-source-wordpress plugin inside of the gatsby-config.js. See the plugin options on schema request concurrency for more information.

// of config,
plugins: [
resolve: `gatsby-source-wordpress`,
options: {
schema: {
perPage: 20, // default 100
requestConcurrency: 5, // default 15
previewRequestConcurrency: 2, // default 5


Disabling the Decoupled Kit Health Check

After you begin editing content in your WordPress CMS, you may find the @pantheon-systems/decoupled-kit-health-check unnecessary. If you would like to remove it from the build step, follow the steps below:

  1. In a text editor, open the package.json
  2. Find the "scripts" and remove "decoupled-kit-health-check": "npx --prefer-offline @pantheon-systems/decoupled-kit-health-check wordpress"
  3. Edit the "build" script and remove npm run decoupled-kit-health-check && from the beginning of the script
  4. Find the "devDependencies" and remove @pantheon-systems/decoupled-kit-health-check, Or in a terminal, run npm rm @pantheon-systems/decoupled-kit-health-check