gatsbyjs/gatsby · error

Image ${file.relativePath} specified only AVIF format, with

Error message

Image ${file.relativePath} specified only AVIF format, with no fallback format. This will mean your site cannot be viewed in all browsers.

What it means

Browser-compatibility warning inside generateImageData (gatsby-plugin-sharp): after format selection, only 'avif' remains (no jpg/png/webp fallback). AVIF is unsupported in older browsers and Safari versions, so users on those browsers will get a broken image unless a fallback format is added. The warning names file.relativePath.

Source

Thrown at packages/gatsby-plugin-sharp/src/image-data.ts:221

  if (formats.has(`jpg`) && formats.has(`png`)) {
    reporter.warn(
      `Specifying both "jpg" and "png" formats is not supported and will be ignored. Please use "auto" instead.`
    )
    useAuto = true
  }

  let primaryFormat: ImageFormat | undefined
  if (useAuto) {
    primaryFormat = normalizeFormat(metadata?.format || file.extension)
  } else if (formats.has(`png`)) {
    primaryFormat = `png`
  } else if (formats.has(`jpg`)) {
    primaryFormat = `jpg`
  } else if (formats.has(`webp`)) {
    primaryFormat = `webp`
  } else if (formats.has(`avif`)) {
    reporter.warn(
      `Image ${file.relativePath} specified only AVIF format, with no fallback format. This will mean your site cannot be viewed in all browsers.`
    )
    primaryFormat = `avif`
  }

  const optionsMap = {
    jpg: args.jpgOptions,
    png: args.pngOptions,
    webp: args.webpOptions,
    avif: args.avifOptions,
  }

  const options = primaryFormat ? optionsMap[primaryFormat] : undefined

  const imageSizes: {
    sizes: Array<number>
    presentationWidth: number
    presentationHeight: number

View on GitHub (pinned to e85d62f177)

Solutions

1. Add a fallback format (e.g. "auto", jpg, png or webp) alongside avif in the formats array

When it happens

Trigger: Thrown at packages/gatsby-plugin-sharp/src/image-data.ts:221 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/71495bd5b90fdf9e. Report an issue: GitHub.