gatsbyjs/gatsby · error

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

Error message

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

What it means

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

Source

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

        }

        return {
          width: dimensions.width,
          height: dimensions.height,
          src: `${pathPrefix}/static/${imageName}`,
        }
      },
    },
    resize: {
      type: new GraphQLObjectType({
        name: `ImageSharpResize`,
        fields: {
          src: { type: GraphQLString },
          tracedSVG: {
            type: GraphQLString,
            resolve: async parent => {
              if (!didShowTraceSVGRemovalWarningResize) {
                console.warn(
                  `"tracedSVG" placeholder field is no longer supported (used in ImageSharp.resize processing), falling back to "base64". See https://gatsby.dev/tracesvg-removal/`
                )
                didShowTraceSVGRemovalWarningResize = true
              }
              const { src } = await base64({
                file: parent.file,
                cache,
              })
              return src
            },
          },
          width: { type: GraphQLInt },
          height: { type: GraphQLInt },
          aspectRatio: { type: GraphQLFloat },
          originalName: { type: GraphQLString },
        },
      }),
      args: {

View on GitHub (pinned to e85d62f177)

Solutions

  1. Stop querying tracedSVG on ImageSharp.resize
  2. Use resize(...).base64 or migrate to gatsbyImageData
  3. Follow https://gatsby.dev/tracesvg-removal/
Defensive patterns

Strategy: fallback

When it happens

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