gatsbyjs/gatsby · error

"tracedSVG" placeholder field is no longer supported (used i

Error message

"tracedSVG" placeholder field is no longer supported (used in ImageSharp.fluid processing), falling back to "base64". See https://gatsby.dev/tracesvg-removal/

What it means

Deprecation shim in the ImageSharp.fluid GraphQL type: the tracedSVG field still exists for schema compatibility, but its resolver only logs this once-per-process warning (didShowTraceSVGRemovalWarningFluid) and returns the base64 blurred placeholder instead of a traced SVG.

Source

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

let didShowTraceSVGRemovalWarningFluid = false
const fluidNodeType = ({
  pathPrefix,
  getNodeAndSavePathDependency,
  reporter,
  name,
  cache,
}) => {
  return {
    type: new GraphQLObjectType({
      name: name,
      fields: {
        base64: { type: GraphQLString },
        tracedSVG: {
          type: GraphQLString,
          resolve: parent => {
            if (!didShowTraceSVGRemovalWarningFluid) {
              console.warn(
                `"tracedSVG" placeholder field is no longer supported (used in ImageSharp.fluid processing), falling back to "base64". See https://gatsby.dev/tracesvg-removal/`
              )
              didShowTraceSVGRemovalWarningFluid = true
            }
            return parent.base64
          },
        },
        aspectRatio: { type: new GraphQLNonNull(GraphQLFloat) },
        src: { type: new GraphQLNonNull(GraphQLString) },
        srcSet: { type: new GraphQLNonNull(GraphQLString) },
        srcWebp: {
          type: GraphQLString,
          resolve: ({ file, image, fieldArgs }) => {
            if (image.extension === `webp` || fieldArgs.toFormat === `webp`) {
              return null
            }
            const args = { ...fieldArgs, pathPrefix, toFormat: `webp` }
            return Promise.resolve(

View on GitHub (pinned to e85d62f177)

Solutions

1. Stop querying tracedSVG on ImageSharp.fluid
2. Remove the tracedSVG argument from your fluid(...) queries
3. Migrate to ImageSharp.gatsbyImageData per https://gatsby.dev/tracesvg-removal/

When it happens

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