Image Transformations

Sets the width of the image in pixels.

Sets the height of the image in pixels.

How the image should be resized to fit the specified dimensions. scale-down scales only if image is larger than dimensions, contain fits within dimensions maintaining aspect ratio, cover fills dimensions cropping if needed, crop crops to exact dimensions, pad adds padding to fit dimensions.

Device Pixel Ratio multiplier. Used for high-density displays.

Output format. auto selects the best format supported by the client (typically WebP or AVIF). baseline-jpeg ensures JPEG compatibility with older browsers. json returns image metadata instead of the image.

Image quality setting. Use numeric values from 1-100 (higher = better quality, larger file size), or predefined levels: high, medium-high, medium-low, low. Lower numeric values reduce file size but may introduce compression artifacts.

Compression speed trade-off.

Applies a Gaussian blur. Value between 1 and 250.

Increases image sharpness. Value between 0 and 10. Higher values produce sharper images but may introduce artifacts.

Adjusts brightness. 1 is original, <1 is darker, >1 is brighter.

Adjusts contrast. 1 is original, <1 is lower, >1 is higher.

Adjusts saturation. 1 is original, 0 is grayscale, >1 is more saturated.

Adjusts gamma correction.

Rotates the image by the specified degrees.

Flips the image horizontally, vertically, or both.

Where to focus when cropping. Use auto to automatically find the best spot, face to focus on faces, or a side like left, right, top, or bottom.

How close to crop around faces. Only works with gravity=face. Use 0 to include more background, 1 to crop tight to faces.

Remove borders from edges. Use border to auto-detect and remove borders, or specify pixels as top;right;bottom;left. Example: 10;20;10;20 removes 10px from top/bottom, 20px from left/right.

Background color for padding or transparent images. Accepts hex codes (URL-encode # as %23, e.g., %23FFFFFF for white) or CSS color names (e.g., white, black, transparent).

Adds a border around the image. Currently only width is supported via query parameters. Specify the border width in pixels (e.g., border=5 for a 5px border). Color customization is not currently available via query parameters.