gatsbyjs/gatsby · error

Adapter "${instance.name}" is not compatible with following

Error message

Adapter "${instance.name}" is not compatible with following settings:
${incompatibleFeatures.map(line => ` - ${line}`).join(`\n`)}

What it means

Guard in setAdapter: the adapter instance declares supports flags (dsg.ssr, trailingSlash, imageCDN, etc.) that exclude settings currently configured for the site, such as a trailingSlash option the adapter does not support. The build proceeds but the listed features will not behave as configured; this is a static compatibility check on the adapter's declared capabilities.

Source

Thrown at packages/gatsby/src/utils/adapter/manager.ts:102

      const { trailingSlash } = store.getState().config

      if (
        !configFromAdapter.supports.trailingSlash.includes(
          trailingSlash ?? `always`
        )
      ) {
        incompatibleFeatures.push(
          `trailingSlash option "${trailingSlash}". Supported option${
            configFromAdapter.supports.trailingSlash.length > 1 ? `s` : ``
          }: ${configFromAdapter.supports.trailingSlash
            .map(option => `"${option}"`)
            .join(`, `)}`
        )
      }
    }

    if (incompatibleFeatures.length > 0) {
      reporter.warn(
        `Adapter "${
          instance.name
        }" is not compatible with following settings:\n${incompatibleFeatures
          .map(line => ` - ${line}`)
          .join(`\n`)}`
      )
    }

    if (configFromAdapter.pluginsToDisable.length > 0) {
      store.dispatch({
        type: `DISABLE_PLUGINS_BY_NAME`,
        payload: {
          pluginsToDisable: configFromAdapter.pluginsToDisable,
          reason: `Not compatible with the "${instance.name}" adapter. Please remove it from your gatsby-config.`,
        },
      })
    }
  }

View on GitHub (pinned to e85d62f177)

Solutions

1. Change the site settings (e.g. trailingSlash) to one of the options the adapter supports
2. Update the adapter to a version that supports the configured features
3. Remove the conflicting feature flags if they are not needed

When it happens

Trigger: Thrown at packages/gatsby/src/utils/adapter/manager.ts:102 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/132a02788c9a59d9. Report an issue: GitHub.