gatsbyjs/gatsby · error

Image not loaded

Error message

Image not loaded

What it means

Server-render warning from _getStaticImage when no imageData was produced for a StaticImage: the image failed at build time (the earlier __error warning holds the cause) and the component renders without an image.

Source

Thrown at packages/gatsby-plugin-image/src/components/static-image.server.tsx:57

    transformOptions,
    jpgOptions,
    pngOptions,
    webpOptions,
    avifOptions,
    blurredOptions,
    breakpoints,
    outputPixelDensities,
    /* eslint-enable @typescript-eslint/no-unused-vars */
    ...props
  }): ReactElement {
    if (__error) {
      console.warn(__error)
    }

    if (imageData) {
      return <GatsbyImage image={imageData} {...props} />
    }
    console.warn(`Image not loaded`, src)
    if (!__error && process.env.NODE_ENV === `development`) {
      console.warn(
        `Please ensure that "gatsby-plugin-image" is included in the plugins array in gatsby-config.js, and that your version of gatsby is at least 2.24.78`
      )
    }
    return null
  }
}

const StaticImage: React.FC<IStaticImageProps & IPrivateProps> =
  _getStaticImage(GatsbyImageServer)

const checkDimensionProps: PropTypes.Validator<number> = (
  props: IStaticImageProps & IPrivateProps,
  propName: keyof IStaticImageProps & IPrivateProps,
  ...rest
) => {
  if (

View on GitHub (pinned to e85d62f177)

Solutions

1. Ensure gatsby-plugin-image is in the plugins array of gatsby-config.js
2. Check the build-time error emitted for this image (bad src path or sharp processing failure)
3. Verify the src prop resolves to a real image

When it happens

Trigger: Thrown at packages/gatsby-plugin-image/src/components/static-image.server.tsx:57 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/6445be0efb472987. Report an issue: GitHub.