# X_IMAGE_TOO_LARGE

## Means

image exceeds the pipeline pixel ceiling

## Typical cause

a header declaring more than 64 megapixels — usually a decompression bomb, occasionally a real scan. A header declaring NO size (zero, negative, fractional) is `X_IMAGE_DECODE_FAILED`, not this

## Fix

downscale the source below the 64-megapixel ceiling before it reaches the pipeline, or route it through an `ImageTransformDriver` (a CDN or an external encoder). `MAX_IMAGE_PIXELS` is fixed, not a setting

[Images](/error-codes#images)