gatsbyjs/gatsby · error

"TRACED_SVG" placeholder argument value is no longer support

Error message

"TRACED_SVG" placeholder argument value is no longer supported (used in gatsbyImageData processing), falling back to "DOMINANT_COLOR". See https://gatsby.dev/tracesvg-removal/

What it means

Error ""TRACED_SVG" placeholder argument value is no longer supported (used in gatsbyImageData processing), falling back to "DOMINANT_COLOR". See https://gatsby.dev/tracesvg-removal/" thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby-plugin-sharp/src/image-data.ts:151

    layout = `constrained`,
    placeholder = `dominantColor`,
    tracedSVGOptions = {},
    transformOptions = {},
    quality,
    backgroundColor,
  } = args

  args.formats = args.formats || [`auto`, `webp`]

  if (layout === `fullWidth`) {
    args.breakpoints = args.breakpoints?.length
      ? args.breakpoints
      : DEFAULT_BREAKPOINTS
  }

  if (placeholder === `tracedSVG`) {
    if (!didShowTraceSVGRemovalWarning) {
      console.warn(
        `"TRACED_SVG" placeholder argument value is no longer supported (used in gatsbyImageData processing), falling back to "DOMINANT_COLOR". See https://gatsby.dev/tracesvg-removal/`
      )
      didShowTraceSVGRemovalWarning = true
    }
    placeholder = `dominantColor`
  }

  const {
    fit = `cover`,
    cropFocus = sharp.strategy.attention,
    duotone,
  } = transformOptions

  if (duotone && (!duotone.highlight || !duotone.shadow)) {
    reporter.warn(
      `Invalid duotone option specified for ${file.absolutePath}, ignoring. Please pass an object to duotone with the keys "highlight" and "shadow" set to the corresponding hex values you want to use.`
    )
  }

View on GitHub (pinned to e85d62f177)

Solutions

  1. Switch placeholder to "blurred" or "dominantColor"
  2. Remove tracedSVGOptions and other tracedSVG-specific settings
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at packages/gatsby-plugin-sharp/src/image-data.ts:151 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/e0e61b2d96d1fbfa. Report an issue: GitHub.