gatsbyjs/gatsby · error

"tracedSVG" plugin option for "gatsby-remark-images" is no l

Error message

"tracedSVG" plugin option for "gatsby-remark-images" is no longer supported. Blurred placeholder will be used. See https://gatsby.dev/tracesvg-removal/

What it means

Deprecation warning from gatsby-remark-images' pluginOptionsSchema custom check: the `tracedSVG` option is still accepted for backwards compatibility but sharp can no longer generate traced-SVG placeholders, so images will use blurred base64 placeholders instead. Emitted once; the option will be removed.

Source

Thrown at packages/gatsby-remark-images/src/gatsby-node.js:92

              `minority`,
              `majority`
            )
            .default(`majority`),
          turdSize: Joi.number().default(100),
          alphaMax: Joi.number(),
          optCurve: Joi.boolean().default(true),
          optTolerance: Joi.number().default(0.4),
          threshold: Joi.alternatives()
            .try(Joi.number().min(0).max(255), Joi.number().valid(-1))
            .default(-1),
          blackOnWhite: Joi.boolean().default(true),
          color: Joi.string().default(`lightgray`),
          background: Joi.string().default(`transparent`),
        })
      )
      .custom(value => {
        if (!!value && !process.env.GATSBY_WORKER_ID) {
          console.warn(
            `"tracedSVG" plugin option for "gatsby-remark-images" is no longer supported. Blurred placeholder will be used. See https://gatsby.dev/tracesvg-removal/`
          )
        }
        return undefined
      })
      .description(
        `Use traced SVGs for placeholder images instead of the “blur up” effect. Pass true for traced SVGs with the default settings (seen here), or an object of options to override the default. For example, pass { color: "#F00", turnPolicy: "TURNPOLICY_MAJORITY" } to change the color of the trace to red and the turn policy to TURNPOLICY_MAJORITY. See node-potrace parameter documentation for a full listing and explanation of the available options.`
      ),
    loading: Joi.string()
      .valid(`lazy`, `eager`, `auto`)
      .default(`lazy`)
      .description(
        `Set the browser’s native lazy loading attribute. One of lazy, eager or auto.`
      ),
    decoding: Joi.string()
      .valid(`async`, `sync`, `auto`)
      .default(`async`)
      .description(

View on GitHub (pinned to e85d62f177)

Solutions

1. Remove tracedSVG options and rely on the default blurred placeholder

When it happens

Trigger: Thrown at packages/gatsby-remark-images/src/gatsby-node.js:92 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/741460c8d2b93b1a. Report an issue: GitHub.