gatsbyjs/gatsby · error

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

Error message

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

What it means

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

Source

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

let didShowTraceSVGRemovalWarningFixed = false
const fixedNodeType = ({
  pathPrefix,
  getNodeAndSavePathDependency,
  reporter,
  name,
  cache,
}) => {
  return {
    type: new GraphQLObjectType({
      name: name,
      fields: {
        base64: { type: GraphQLString },
        tracedSVG: {
          type: GraphQLString,
          resolve: parent => {
            if (!didShowTraceSVGRemovalWarningFixed) {
              console.warn(
                `"tracedSVG" placeholder field is no longer supported (used in ImageSharp.fixed processing), falling back to "base64". See https://gatsby.dev/tracesvg-removal/`
              )
              didShowTraceSVGRemovalWarningFixed = true
            }
            return parent.base64
          },
        },
        aspectRatio: { type: GraphQLFloat },
        width: { type: new GraphQLNonNull(GraphQLFloat) },
        height: { type: new GraphQLNonNull(GraphQLFloat) },
        src: { type: new GraphQLNonNull(GraphQLString) },
        srcSet: { type: new GraphQLNonNull(GraphQLString) },
        srcWebp: {
          type: GraphQLString,
          resolve: ({ file, image, fieldArgs }) => {
            // If the file is already in webp format or should explicitly
            // be converted to webp, we do not create additional webp files
            if (file.extension === `webp` || fieldArgs.toFormat === `webp`) {

View on GitHub (pinned to e85d62f177)

Solutions

1. Stop querying tracedSVG on ImageSharp.fixed
2. Remove the tracedSVG argument from your fixed(...) queries
3. Switch to gatsbyImageData with the default or DOMINANT_COLOR placeholder per https://gatsby.dev/migrate-images

When it happens

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