{"record":{"id":"dc9a1ee42a9cacbc","repo":"gatsbyjs/gatsby","slug":"the-requested-fixeddimension-fixeddimension","errorCode":null,"errorMessage":"The requested ${fixedDimension} \"${fixedDimension === `width` ? width : height}px\" for the image ${filename} was larger than the actual image ${fixedDimension} of ${imgDimensions[fixedDimension]}px. If possible, replace the current image with a larger one.","messagePattern":"The requested (.+?) \"(.+?)px\" for the image (.+?) was larger than the actual image (.+?) of (.+?)px\\. If possible, replace the current image with a larger one\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-plugin-image/src/image-utils.ts","lineNumber":453,"sourceCode":"  if (!width) {\n    if (!height) {\n      width = DEFAULT_FIXED_WIDTH\n    } else {\n      width = Math.round(height * aspectRatio)\n    }\n  } else if (!height) {\n    height = Math.round(width / aspectRatio)\n  }\n\n  const originalWidth = width // will use this for presentationWidth, don't want to lose it\n  const isTopSizeOverriden =\n    imgDimensions.width < width || imgDimensions.height < (height as number)\n\n  // If the image is smaller than requested, warn the user that it's being processed as such\n  // print out this message with the necessary information before we overwrite it for sizing\n  if (isTopSizeOverriden) {\n    const fixedDimension = imgDimensions.width < width ? `width` : `height`\n    reporter.warn(`\nThe requested ${fixedDimension} \"${\n      fixedDimension === `width` ? width : height\n    }px\" for the image ${filename} was larger than the actual image ${fixedDimension} of ${\n      imgDimensions[fixedDimension]\n    }px. If possible, replace the current image with a larger one.`)\n\n    if (fixedDimension === `width`) {\n      width = imgDimensions.width\n      height = Math.round(width / aspectRatio)\n    } else {\n      height = imgDimensions.height\n      width = height * aspectRatio\n    }\n  }\n\n  const sizes = densities\n    .filter(size => size >= 1) // remove smaller densities because fixed images don't need them\n    .map(density => Math.round(density * (width as number)))","sourceCodeStart":435,"sourceCodeEnd":471,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-plugin-image/src/image-utils.ts#L435-L471","documentation":"Error \"The requested ${fixedDimension} \"${fixedDimension === `width` ? width : height}px\" for the image ${filename} was larger than the actual image ${fixedDimension} of ${imgDimensions[fixedDimension]}px. If possible, replace the current image with a larger one.\" thrown in gatsbyjs/gatsby.","triggerScenarios":"Thrown at packages/gatsby-plugin-image/src/image-utils.ts:453 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Provide a larger source image","Request smaller width/height matching the actual image dimensions"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}