gatsbyjs/gatsby · error

traceSVG placeholder generation is no longer supported, fall

Error message

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

What it means

Removal notice in gatsby-plugin-sharp's traceSVG stub: traced-SVG placeholders were removed from sharp, so any call to traceSVG() now logs this once (guarded by didShowTraceSVGRemovalWarning) and falls back to the blurred base64 placeholder. getTracedSVG resolvers that still call it get blurred output instead.

Source

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

  const result = await processFn(arg)
  await cache.set(cachedKey, result)

  return result
}

async function base64(arg) {
  if (arg.cache) {
    // Not all transformer plugins are going to provide cache
    return await cachifiedProcess(arg, generateCacheKey, generateBase64)
  }

  return await memoizedBase64(arg)
}

let didShowTraceSVGRemovalWarning = false
async function traceSVG(args) {
  if (!didShowTraceSVGRemovalWarning) {
    console.warn(
      `traceSVG placeholder generation is no longer supported, falling back to blurred. See https://gatsby.dev/tracesvg-removal/`
    )
    didShowTraceSVGRemovalWarning = true
  }

  const { src } = await base64(args)
  return src
}

async function stats({ file, reporter }) {
  const pluginOptions = getPluginOptions()
  let imgStats
  try {
    const pipeline = sharp({ failOn: pluginOptions.failOn })
    fs.createReadStream(file.absolutePath).pipe(pipeline)

    imgStats = await pipeline.stats()
  } catch (err) {

View on GitHub (pinned to e85d62f177)

Solutions

1. Use placeholder: "blurred" instead
2. Remove tracedSVG options from gatsbyImageData arguments

When it happens

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