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

Source

Thrown at packages/gatsby-transformer-sharp/src/customize-schema.js:534

        type: TransformOptionsType,
        description: `Options to pass to sharp to control cropping and other image manipulations.`,
      },
      backgroundColor: {
        type: GraphQLString,
        description: `Background color applied to the wrapper. Also passed to sharp to use as a background when "letterboxing" an image to another aspect ratio.`,
      },
    },
    resolve: async (image, fieldArgs, context) => {
      const file = getNodeAndSavePathDependency(image.parent, context.path)

      if (!generateImageData) {
        reporter.warn(`Please upgrade gatsby-plugin-sharp`)
        return null
      }

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

      const imageData = await generateImageData({
        file,
        args: fieldArgs,
        pathPrefix,
        reporter,
        cache,
      })

      return imageData
    },
  }

View on GitHub (pinned to e85d62f177)

Solutions

1. Remove TRACED_SVG from the placeholder argument of your gatsbyImageData(...) queries
2. Use the default BLURRED or DOMINANT_COLOR placeholder instead
3. See https://gatsby.dev/tracesvg-removal/ for the full migration notes

When it happens

Trigger: Thrown at packages/gatsby-transformer-sharp/src/customize-schema.js:534 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/a5b84447c2cc3c92. Report an issue: GitHub.