The image "${node.url}" (with alt text: "${node.alt}") doesn

Error message

The image "${node.url}" (with alt text: "${node.alt}") doesn't appear to be a supported image format.

What it means

Error "The image "${node.url}" (with alt text: "${node.alt}") doesn't appear to be a supported image format." thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby-remark-images-contentful/src/index.js:92

        url: originalImg, // for some reason there is a './' prefix
        responseType: `stream`,
      })
    } catch (err) {
      reporter.panic(
        `Image downloading failed for ${originalImg}, please check if the image still exists on contentful`,
        err
      )
      return []
    }

    response.data.pipe(metaReader)

    let metadata
    try {
      metadata = await metaReader.metadata()
    } catch (error) {
      console.log(error)
      reporter.panic(
        `The image "${node.url}" (with alt text: "${node.alt}") doesn't appear to be a supported image format.`,
        error
      )
    }

    response.data.destroy()

    const responsiveSizesResult = await buildResponsiveSizes(
      {
        metadata,
        imageUrl: originalImg,
        options,
      },
      reporter
    )

    // Calculate the paddingBottom %
    const ratio = `${(1 / responsiveSizesResult.aspectRatio) * 100}%`

View on GitHub (pinned to 8b06340921)

Solutions

Verify the image URL points to a supported format (JPEG, PNG, GIF, WebP, AVIF). Convert or replace the image in Contentful if it uses an unsupported format.
Check that the Contentful asset is published and the URL returns an image content type rather than an error page or JSON.

When it happens

Trigger: Thrown at packages/gatsby-remark-images-contentful/src/index.js:92 when the library encounters an invalid state.

Common situations: Occurs in gatsby-remark-images-contentful when a Contentful image node URL points to a format Sharp cannot process (e.g. SVG, TIFF, or a broken URL). Prevent it by confirming the asset in Contentful is a supported raster format (JPEG, PNG, WebP, GIF) and that the URL is reachable.

AI-assisted analysis of gatsbyjs/gatsby@8b06340921 (2026-08-13). Data as JSON: /api/errors/ca4234783b5e2fa6. Report an issue: GitHub.