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

Source

Thrown at packages/gatsby-source-contentful/src/gatsby-plugin-image.js:292

  const defaults = {
    tracedSVGOptions: {},
    blurredOptions: {},
    jpgOptions: {},
    pngOptions: {},
    webpOptions: {},
    gifOptions: {},
    avifOptions: {},
    quality: 50,
    placeholder: `dominantColor`,
    ...userDefaults,
  }

  options = doMergeDefaults(options, defaults)

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

  const { baseUrl, contentType, width, height } = getBasicImageProps(
    image,
    options
  )
  let [, format] = contentType.split(`/`)
  if (format === `jpeg`) {
    format = `jpg`
  }

  // Translate Contentful resize parameter to gatsby-plugin-image css object fit
  const fitMap = new Map([

View on GitHub (pinned to e85d62f177)

Solutions

1. Change the placeholder option to DOMINANT_COLOR, BLURRED, or NONE.
2. Remove the placeholder option entirely to use the dominantColor default.
3. Update any shared image component defaults that still pass tracedSVG.
4. See https://gatsby.dev/tracesvg-removal/ for migration guidance.

When it happens

Trigger: Thrown at packages/gatsby-source-contentful/src/gatsby-plugin-image.js:292 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/38db6c0bea0705ae. Report an issue: GitHub.