gatsbyjs/gatsby · error

tracedSVG placeholder generation for fluid images is no long

Error message

tracedSVG placeholder generation for fluid 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 fluid() resolver: the query passed generateTracedSVG + tracedSVG options, but traced-SVG generation for fluid images was removed. The flag-prefixed warning fires once per process (didShowTraceSVGRemovalWarningFluid) and the resolver falls back to blurred base64 placeholders.

Source

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

      } else {
        arrrgs.height = Math.round(
          size * (options.maxHeight / options.maxWidth)
        )
      }
    }

    return arrrgs
  })

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

  if (options.generateTracedSVG && options.tracedSVG) {
    if (!didShowTraceSVGRemovalWarningFluid) {
      console.warn(
        `tracedSVG placeholder generation for fluid images is no longer supported, falling back to blurred. See https://gatsby.dev/tracesvg-removal/`
      )
      didShowTraceSVGRemovalWarningFluid = 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. Drop the tracedSVG/generateTracedSVG options
2. Use the blurred placeholder instead

When it happens

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