Fixed

• Fix parsing and minifying some SVGs.

Added

• Add IMGPROXY_MAX_RESULT_DIMENSION config and max_result_dimension processing option.
• Add IMGPROXY_ALLOWED_PROCESSING_OPTIONS config.
• (pro) Add IMGPROXY_ALLOWED_INFO_OPTIONS config.
• (pro) Add IMGPROXY_MAX_CHAINED_PIPELINES config.
• Add imgproxy.source_image_origin attribute to New Relic, DataDog, and OpenTelemetry traces.
• Add imgproxy.source_image_url and imgproxy.source_image_origin attributes to downloading_image spans in New Relic, DataDog, and OpenTelemetry traces.
• Add imgproxy.processing_options attribute to processing_image spans in New Relic, DataDog, and OpenTelemetry traces.
• Add Source Image Origin attribute to error reports.
• Add workers and workers_utilization metrics to all metrics services.
• (pro) Add crop_aspect_ratio processing option.
• (pro) Add IMGPROXY_PDF_NO_BACKGROUND config.
• Add IMGPROXY_WEBP_EFFORT config.
• Add IMGPROXY_WEBP_PRESET config.
• (pro) Add support for saving images as PDF.

Changed

• Suppress "Response has no supported checksum" warnings from S3 SDK.
• The IMGPROXY_USER_AGENT config now supports the %current_version variable that is replaced with the current imgproxy version.
• (docker) Optimized image quantization.
• (pro) Improved BlurHash generation performance.

Fixed

• Fix X-Origin-Content-Length header value when SVG is sanitized or minified.
• Mark JPEG XL format as supporting quality. Fixes autoquality for JPEG XL.
• Fix the extend processing option when only one dimension is set.
• (pro) Fix object detection when the IMGPROXY_USE_LINEAR_COLORSPACE config is set to true.
• (pro) Fix BlurHash generation when the IMGPROXY_USE_LINEAR_COLORSPACE config is set to true.
• (pro) Fix detection of PDF files with a header offset.

Removed

• Remove the IMGPROXY_SVG_FIX_UNSUPPORTED config. The problem it was solving is now fixed in librsvg.

Added

• Add IMGPROXY_BASE64_URL_INCLUDES_FILENAME config.
• Add IMGPROXY_COOKIE_PASSTHROUGH_ALL config.
• (pro) Add PNG EXIF and XMP data to the /info endpoint response.
• (pro) Add the mime_type field to the /info endpoint response.

Changed

• Treat 206 (Partial Content) responses from a source server as 200 (OK) when they contain a full content range.
• Improved error reporting.
• (pro) Change saturation adjustment algorithm to be more CIE-correct.
• (pro) Don't check image complexity during best format selection when IMGPROXY_BEST_FORMAT_COMPLEXITY_THRESHOLD is set to 0.

Fixed

• Fix determinimg the default hostname for cookies passthrough.
• (pro) Fix setting the Host header with the IMGPROXY_CUSTOM_REQUEST_HEADERS config.
• (pro) Fix passing through the Host header with the IMGPROXY_REQUEST_HEADERS_PASSTHROUGH config.
• (pro) Fix passing through request headers with the IMGPROXY_REQUEST_HEADERS_PASSTHROUGH when the raw option is used.
• (pro) Fix IMGPROXY_BEST_FORMAT_ALLOW_SKIPS config behavior.
• (pro) Fix flattening behavior when chained pipelines are used and the resulting format doesn't support transparency.
• (pro) Fix advanced smart crop when the most feature points are located close to the right or the bottom edge.

Removed

• Remove the IMGPROXY_S3_MULTI_REGION config. imgproxy now always work in multi-regional S3 mode.

Fixed

• Fix preventing requests to 0.0.0.0 when imgproxy is configured to deny loopback addresses.
• (pro) Fix timeouts in AWS Lambda when running in development mode.

Added

• Add IMGPROXY_SOURCE_URL_QUERY_SEPARATOR config.
• (pro) Add YOLOv11 object detection model support.

Changed

• (pro) Improve image complexity calculation for best format selection.
• (pro) Use PNG quantization for very low-complexity images when the best format is used.

Fixed

• Fix blur and sharpen performance for images with alpha channel.
• (pro) Fix object detecttion accuracy.

Add

• Add JPEG XL (JXL) support.
• Add PSD (Photoshop Document) and PSB (Photoshop Big) images support.
• Add IMGPROXY_AUTO_JXL, IMGPROXY_ENFORCE_JXL, and IMGPROXY_JXL_EFFORT configs.
• (pro) Add IMGPROXY_AUTOQUALITY_JXL_NET config.
• (pro) Add objects_position processing and info options.
• (pro) Add IMGPROXY_OBJECT_DETECTION_SWAP_RB config.
• (pro) Add IMGPROXY_OBJECT_DETECTION_GRAVITY_MODE config.

Changed

• Change IMGPROXY_AVIF_SPEED default value to 8.
• Change IMGPROXY_FORMAT_QUALITY default value to webp=79,avif=63,jxl=77.
• Rename IMGPROXY_ENABLE_WEBP_DETECTION to IMGPROXY_AUTO_WEBP. The old name is deprecated but still supported.
• Rename IMGPROXY_ENABLE_AVIF_DETECTION to IMGPROXY_AUTO_AVIF. The old name is deprecated but still supported.
• (pro) Change IMGPROXY_AUTOQUALITY_FORMAT_MIN default value to avif=60.
• (pro) Change IMGPROXY_AUTOQUALITY_FORMAT_MAX default value to avif=65.
• (pro) Use the last page/frame of the source image when the page processing option value is greater than or equal to the number of pages/frames in the source image.

Fixed

• Fix detecting of width and height of HEIF images that include irot boxes.
• Set Error status for errorred traces in OpenTelemetry.
• Fix URL parsing error when a non-http(s) URL contains a % symbol outside of the percent-encoded sequence.
• Fix importing ICC profiles for 16-bit images with an alpha channel.
• Fix handling ICC profiles with vips 8.15+.
• (pro) Fix opject detection accuracy when using YOLOv8 or YOLOv10 models.
• (pro) Fix usage of the obj and objw gravity types inside the crop processing option.
• (pro) Fix detecting of width and height when orientation is specified in EXIF but EXIF info is not requested.
• (pro) Fix watermark shadow clipping.

Deprecated

• IMGPROXY_ENABLE_WEBP_DETECTION config is deprecated. Use IMGPROXY_AUTO_WEBP instead.
• IMGPROXY_ENABLE_AVIF_DETECTION config is deprecated. Use IMGPROXY_AUTO_AVIF instead.

Changed

• (pro) Improve monochrome and duotone processing options.

Fixed

• Fix loading log configs from local files and secret managers.
• Fix detecting HEIF images with the heix brand.
• Fix downloading source images when the image source requires a cookie challenge.
• (pro) Fix playback of videos created from animations in Google Chrome.
• (pro) Fix detecting of width and height of HEIF images that have orientation specified in EXIF.

Added

• Add imgproxy.source_image_url and imgproxy.processing_options attributes to New Relic, DataDog, and OpenTelemetry traces.
• Add IMGPROXY_S3_ENDPOINT_USE_PATH_STYLE config.
• (pro) Add monochrome processing option.
• (pro) Add duotone processing option.
• (pro) Add objw gravity type.
• (pro) Add an object pseudo-class all that can be used with the obj and objw gravity types to match all detected objects.
• (pro) Add IMGPROXY_SMART_CROP_ADVANCED_MODE config.
• (pro) Add IMGPROXY_OBJECT_DETECTION_FALLBACK_TO_SMART_CROP config.
• (docker) Add a script for building Linux packages.

Changed

• Properly set the net.host.name and http.url tags in OpenTelemetry traces.
• (pro) Object detection: class names file can contain object classes' weights.

Fixed

• Fix handling # symbols in local://, s3://, gcs://, abs://, and swift:// URLs.
• Fix IMGPROXY_FALLBACK_IMAGE_HTTP_CODE value check. Allow 0 value.
• (docker) Fix loading HEIC images made with iOS 18.

Add

• Add IMGPROXY_S3_ASSUME_ROLE_EXTERNAL_ID config.
• Add IMGPROXY_WRITE_RESPONSE_TIMEOUT config.
• Add IMGPROXY_REPORT_IO_ERRORS config.
• Add IMGPROXY_ARGUMENTS_SEPARATOR config.
• Add IMGPROXY_PRESETS_SEPARATOR config.
• (pro) Add support for object detection models in ONNX format.
• (pro) Add colorize processing option.
• (pro) Add IMGPROXY_WATERMARK_PREPROCESS_URL config.
• (pro) Add IMGPROXY_FALLBACK_IMAGE_PREPROCESS_URL config.

Changed

• Automatically add http:// scheme to the IMGPROXY_S3_ENDPOINT value if it has no scheme.
• Trim redundant slashes in the S3, GCS, ABS, and Swift object keys.
• Rename IMGPROXY_WRITE_TIMEOUT to IMGPROXY_TIMEOUT. The old name is deprecated but still supported.
• Rename IMGPROXY_READ_TIMEOUT to IMGPROXY_READ_REQUEST_TIMEOUT. The old name is deprecated but still supported.
• (pro) Allow specifying gradient direction as an angle in degrees.
• (pro) Speed up ML features.
• (pro) Update the face detection model.

Fix

• Fix HEIC/AVIF dimension limit handling.
• Fix SVG detection when the root element has a namespace.
• Fix treating percent-encoded symbols in s3://, gcs://, abs://, and swift:// URLs.
• (pro) Fix style injection to SVG.
• (pro) Fix video tiles generation when the video's SAR is not 1.

Deprecated

• IMGPROXY_WRITE_TIMEOUT config is deprecated. Use IMGPROXY_TIMEOUT instead.
• IMGPROXY_READ_TIMEOUT config is deprecated. Use IMGPROXY_READ_REQUEST_TIMEOUT instead.

Fix

• Fix the default IMGPROXY_WORKERS value when cgroup limits are applied.