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


Decoupled Kit Health Check is Failing Valid Builds

Opt Out With an Environment Variable

To opt out of the health check, set the NO_DKHC environment variable. If this variable is set to anything, the health check will be skipped.

Unset the variable to continue running the health check before the build step.

Remove the 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