gatsbyjs/gatsby · error

tracedSVG placeholder generation for fixed images is no long

Error message

tracedSVG placeholder generation for fixed images is no longer supported, falling back to blurred. See https://gatsby.dev/tracesvg-removal/

What it means

Removal notice in gatsby-plugin-sharp's fixed() resolver: the query passed generateTracedSVG + tracedSVG options, but traced-SVG generation for fixed images was removed. The warning fires once per process (didShowTraceSVGRemovalWarningFixed) and the resolver falls back to blurred base64 placeholders.

Source

Thrown at packages/gatsby-plugin-sharp/src/index.js:692

      arrrgs.height = Math.round(size * (options.height / options.width))
    }
    // we need pathPrefix to calculate the correct outputPath
    if (options.pathPrefix) {
      arrrgs.pathPrefix = options.pathPrefix
    }

    return arrrgs
  })

  const images = batchQueueImageResizing({
    file,
    transforms,
    reporter,
  })

  if (options.generateTracedSVG && options.tracedSVG) {
    if (!didShowTraceSVGRemovalWarningFixed) {
      console.warn(
        `tracedSVG placeholder generation for fixed images is no longer supported, falling back to blurred. See https://gatsby.dev/tracesvg-removal/`
      )
      didShowTraceSVGRemovalWarningFixed = true
    }
  }

  let base64Image
  if (options.base64 || (options.generateTracedSVG && options.tracedSVG)) {
    const base64Width = options.base64Width
    const base64Height = Math.max(
      1,
      Math.round(base64Width / images[0].aspectRatio)
    )
    const base64Args = {
      background: options.background,
      duotone: options.duotone,
      grayscale: options.grayscale,
      rotate: options.rotate,

View on GitHub (pinned to e85d62f177)

Solutions

1. Remove tracedSVG/generateTracedSVG options and use the blurred placeholder

When it happens

Trigger: Thrown at packages/gatsby-plugin-sharp/src/index.js:692 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/f9b26f1d5df2a4e1. Report an issue: GitHub.