Features | imgproxy: fast and secure on-the-fly image processing

Image formats

imgproxy works with JPEG, PNG, WebP, AVIF, JPEG XL, GIF, SVG, ICO, HEIC, BMP, TIFF, and animated GIF and WebP formats

GIF to MP4 conversion

Reduce animations size dramatically

PDF thumbnail generation

Turn any page from a PDF file into a preview image

Video thumbnail generation

Turn any frame from a video file into a preview image

PSD/PSB (Photoshop Document) thumbnail generation

Image processing

Resizing

imgproxy can resize images to any size

Resizing with a specified algorithm

Linear, cubic, Lanczos3, etc.

Padding

Add specified space around an image

Extending

Top up some space if the image size is less than required

Flattening

Fill transparent areas with a specified color

Flattening with a semi-transparent background

Watermarking

Add a logo or copyright text to images

Watermarking with custom per-request watermarks

Use different watermarks for different images by specifying their URLs

Text watermarks

Create watermarks from specified text

Watermark shadow

Add a shadow to the watermark to make it more visible

Filters

Blurring, sharpening, pixelation

Unsharp masking

Reduce the blurriness appeared after resizing

Color adjustment

Saturation, contrast, brightness

Color filters

Monochrome, duotone

Colorize

Place a color overlay on the image

Gradient

Place a gradient overlay on the image

Injecting styles into SVG

Inject custom CSS into SVG

Chained processing pipelines

Customize the processing order and specify multiple pipelines using a single URL

Image optimization

Saving with specified quality

When supported by the resulting format

Atomatically serve images in WebP/AVIF/JPEG XL format if the browser supports it

Auto PNG quantization

Automatically save PNG images in 8-bit palette mode if the source image is also an 8-bit image

Stripping image metadata

Purge image EXIF, XMP, IPTC and other metadata to decrease the image file size

Keeping copyright

Keep the copyright information when stripping metadata

Stripping image's ICC profile

Convert the image to sRGB and strip the ICC profile to decrease the image file size

Advanced JPEG optimizations

Squeeze the size of your JPEGs to the last byte without compromising on quality

Advanced WebP compression options

Specifying compression parameters via URL

SVG minification

Cleans an image of line breaks, comments, etc.

Smart features

Smart crop

Find the best area to crop based on edges, saturation, and skin tone

Advanced smart crop

Find the best area to crop based image's feature points and simple face detection

Object-oriented crop

Detect objects in the image using AI algorithms and crop the image around them

Object blurring

Detect objects in the image using AI algorithms and blur them

Autoquality by the result file size

Select the quality at which the resulting file will not be larger than the specified size

Autoquality by DSSIM

Sutomatic quality coefficient determination to reach maximum image compression while keeping the image quality

Automatic best format selection

Automatically select the resulting format that provides the best compression ratio

Security

Source image URL encryption

Hide the source image URL from the end user

Authorization with the HTTP Authorization header

Source image resolution restriction

Protect from "zip bombs" by cancelling image processing if the source image is too large

Source image file size restriction

Animation frames number restriction

Allowed image source restriction

Source image hashsum verification

URL expiration

Set a time limit for the URL to be valid

SVG sanitization

Remove potentially dangerous content from SVG files

Image sources support

Amazon S3

And S3-compatible storages: MinIO, Cloudflare R2, Wasabi, etc.

OpenStack Object Storage ("Swift")

Monitoring

Errors reporting

Miscellaneous

Image info

Get info about the image format, size, metadata, and more

Presets

Create named presets and use them as shortcuts in the URL

Fallback image

If imgproxy cannot download the original image, it uses the fallback specified in the settings

Per-request fallback images

Specify a fallback image in the URL overriding the default one

Skip processing

Specify the image formats you don’t want to be processed

Raw files streaming

Stream raw files without any processing or checking

ETag support

Use HTTP protocol's ETags for more efficient caching

Cookie pass-through

Pass cookies from the client request to the source image server

Custom source image request headers

Specify HTTP headers that will be sent to the source image server

Request headers pass-through

Specify which HTTP headers will be passed from the client request to the source image server

Custom response headers

Specify HTTP headers that will be sent in the response to the client

Response headers pass-through

Specify which HTTP headers will be passed from the source image server response to the client

Still have questions? Get all the answers in the FAQ

Start your free trial today