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 gatsbyImage 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 gatsbyImage processing), falling back to "DOMINANT_COLOR". See https://gatsby.dev/tracesvg-removal/" thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby-plugin-utils/src/polyfill-remote-file/graphql/gatsby-image-resolver.ts:127

  }

  if (!args.outputPixelDensities) {
    args.outputPixelDensities = DEFAULT_PIXEL_DENSITIES
  }

  if (!args.breakpoints) {
    args.breakpoints = DEFAULT_BREAKPOINTS
  }

  if (!args.fit) {
    args.fit = `cover`
  }

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

  if (!args.quality) {
    args.quality = DEFAULT_QUALITY
  }

  let backgroundColor = args.backgroundColor
  const sourceMetadata: ISourceMetadata = {
    width: source.width,
    height: source.height,
    format: getImageFormatFromMimeType(source.mimeType),
    filename: source.filename,
  }

View on GitHub (pinned to e85d62f177)

Solutions

  1. Use the dominantColor or blurred placeholder instead
  2. Remove TRACED_SVG usages from gatsbyImage arguments
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at packages/gatsby-plugin-utils/src/polyfill-remote-file/graphql/gatsby-image-resolver.ts:127 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/e8970c33c2b85c72. Report an issue: GitHub.