gatsbyjs/gatsby · error

[gatsby-transformer-sharp] The "fixed" and "fluid" resolvers

Error message

[gatsby-transformer-sharp] The "fixed" and "fluid" resolvers are now deprecated. Switch to "gatsby-plugin-image" for better performance and a simpler API. See https://gatsby.dev/migrate-images to learn how.

What it means

Error "[gatsby-transformer-sharp] The "fixed" and "fluid" resolvers are now deprecated. Switch to "gatsby-plugin-image" for better performance and a simpler API. See https://gatsby.dev/migrate-images to learn how." thrown in gatsbyjs/gatsby.

Source

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

  ImagePlaceholderType,
  JPGOptionsType,
  PNGOptionsType,
  WebPOptionsType,
  BlurredOptionsType,
  TransformOptionsType,
  AVIFOptionsType,
} = require(`./types`)
const { stripIndent } = require(`common-tags`)
const { prefixId, CODES } = require(`./error-utils`)

let warnedForDeprecation = false

function warnForDeprecation() {
  if (warnedForDeprecation) {
    return
  }
  warnedForDeprecation = true
  console.warn(
    `[gatsby-transformer-sharp] The "fixed" and "fluid" resolvers are now deprecated. Switch to "gatsby-plugin-image" for better performance and a simpler API. See https://gatsby.dev/migrate-images to learn how.`
  )
}

function toArray(buf) {
  const arr = new Array(buf.length)

  for (let i = 0; i < buf.length; i++) {
    arr[i] = buf[i]
  }

  return arr
}

let didShowTraceSVGRemovalWarningFixed = false
const fixedNodeType = ({
  pathPrefix,
  getNodeAndSavePathDependency,

View on GitHub (pinned to e85d62f177)

Solutions

1. Replace `fixed` and `fluid` queries in GraphQL with the gatsbyImageData field
2. Migrate <Img fixed={...}>/<Img fluid={...}> usages to <GatsbyImage image={...}> from gatsby-plugin-image
3. Follow the migration guide at https://gatsby.dev/migrate-images (codemods are available)
4. Remove gatsby-image from dependencies once no queries use fixed/fluid

When it happens

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