gatsbyjs/gatsby · error

Ignoring incompatible ${adapterToUse.module}@${adapterInstal

Error message

Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}

What it means

Error "Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}" thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby/src/utils/adapter/init.ts:187

    )
  }

  {
    // 3. Check if the user has manually installed the adapter and try to resolve it from there
    const adapterInstalledByUserResults =
      await tryLoadingAlreadyInstalledAdapter({
        adapterToUse,
        installLocation: process.cwd(),
        currentGatsbyVersion,
      })
    if (adapterInstalledByUserResults.found) {
      if (adapterInstalledByUserResults.compatible) {
        reporter.verbose(
          `Using site's adapter dependency "${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion}"`
        )
        return adapterInstalledByUserResults.loadedModule
      } else {
        reporter.warn(
          `Ignoring incompatible ${adapterToUse.module}@${adapterInstalledByUserResults.installedVersion} installed by site. ${adapterInstalledByUserResults.incompatibilityReason}`
        )
      }
    }
  }

  {
    // 4. Check if a previous run has installed the correct adapter into .cache/adapters already and try to resolve it from there
    const adapterPreviouslyInstalledInCacheAdaptersResults =
      await tryLoadingAlreadyInstalledAdapter({
        adapterToUse,
        installLocation: getAdaptersCacheDir(),
        currentGatsbyVersion,
      })

    if (adapterPreviouslyInstalledInCacheAdaptersResults.found) {
      if (adapterPreviouslyInstalledInCacheAdaptersResults.compatible) {
        reporter.verbose(

View on GitHub (pinned to e85d62f177)

Solutions

1. Upgrade or downgrade the site-installed adapter to a version compatible with the current Gatsby version
2. Remove the site-installed adapter to let zero-configuration deployment pick a compatible one
3. Fix the root incompatibilityReason reported (e.g. peer dependency mismatch on gatsby) and reinstall

When it happens

Trigger: Thrown at packages/gatsby/src/utils/adapter/init.ts:187 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/898c4f1dee1ee2e6. Report an issue: GitHub.