gatsbyjs/gatsby · error

"TRACED_SVG" placeholder is no longer supported, falling bac

Error message

"TRACED_SVG" placeholder is no longer supported, falling back to "BLURRED". See https://gatsby.dev/tracesvg-removal/

What it means

Image CDN placeholder-handler notice: a TRACED_SVG placeholder request reached the handler (the field-resolver fallback missed it); it falls back to BLURRED because its data shape is compatible, unlike DOMINANT_COLOR. Printed once per process.

Source

Thrown at packages/gatsby-plugin-utils/src/polyfill-remote-file/placeholder-handler.ts:75

    const cache = getCache()
    tmpDir = await mkdtemp(path.join(cache.directory, `placeholder-`))
  }

  const httpHeaders = getRequestHeadersForUrl(url, store)

  const filePath = await fetchRemoteFile({
    url,
    cacheKey: contentDigest,
    directory: tmpDir,
    httpHeaders,
  })

  if (type === PlaceholderType.TRACED_SVG) {
    if (!didShowTraceSVGRemovalWarning) {
      // we should not hit this code path, field resolver should fallback earlier, this is just in-case.
      // also this falls back to BLURRED because the shape is compatible. DOMINANT_COLOR is not compatible
      // and fallback to DOMINANT_COLOR need to happen very early on and not when already generating value
      console.warn(
        `"TRACED_SVG" placeholder is no longer supported, falling back to "BLURRED". See https://gatsby.dev/tracesvg-removal/`
      )
      didShowTraceSVGRemovalWarning = true
    }
    type = PlaceholderType.BLURRED
  }

  switch (type) {
    case PlaceholderType.BLURRED: {
      let buffer: Buffer

      try {
        const fileStream = createReadStream(filePath)
        const pipeline = sharp()
        fileStream.pipe(pipeline)
        buffer = await pipeline
          .resize(
            PLACEHOLDER_BASE64_WIDTH,

View on GitHub (pinned to e85d62f177)

Solutions

1. Switch the placeholder argument to "blurred" or "dominantColor"

When it happens

Trigger: Thrown at packages/gatsby-plugin-utils/src/polyfill-remote-file/placeholder-handler.ts:75 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/a26ed49d49e05441. Report an issue: GitHub.